Interesting article giving the perspective of someone who has been away from TiddlyWiki for a few years:
Way back in the mists of time (actually, January 2009) I wrote about a really cool tool called TiddlyWiki, a “non-linear personal web notebook”. Fast forward to today and I just had an out of body experience: Completely by accident I found a TiddlyWiki that I started when I wrote that piece and it still works!
Finding code that works flawlessly after just two or three years is magical enough but after seven years?! And given that TiddlyWiki is written as a single page Web application and considering how different browsers are now than they were in 2009, the fact that the old version of TiddlyWiki still works is not short of miraculous.
Cuaderno de tesis basado en TiddlyWiki
Este es un ejemplo de cuaderno de tesis, construido sobre TiddlyWiki 5.0.8-beta.
TiddlyWiki es un gran programa creado por Jeremy Ruston. Te permite, entre otras cosas, tomar notas, organizar ideaas, guardar información y ver todas tus cosas de la forma que queres. Es una herramiente increíblemente flexible que puedes adaptar para que satisfaga casi todas tus necesidades.
Este TiddlyWiki ha sido adaptado para servir de cuaderno de notas de filosofía, centrado en autores, libros y artículos, conceptos y teorías, además de notas personales. Lo uso junto con Zotero, que es un programa de bibliografía. Ambos son proyectos gratuitos de código abierto. TiddlyWiki se puede descargar de https://tiddlywiki.com
A desktop application for TiddlyWiki, running on Windows.
https://lamusia.github.io/#ATWiki
TiddlyWiki for Windows. A unique non-linear notebook for capturing, organising and sharing complex information.
buggyj has created several useful plugins, including a WYSIWYG HTML editor, a configurable calendar and tag lists with draggable ordering.
A collection of customisations and macros from Danielo Rodriguez.
http://braintest.tiddlyspot.com/
This is my personal tiddlywiki file for testing.
Here I will post the tools and Macros that I develop for this awesome tool. That way, all the help the comunity gave me can came back to the comunity again.
Task & Delegation Tracking, Meetings & Agenda Items, Project Roles, Progress & Status Updates, Reference Items, Tickler Calendar, Conversation Logging, Book Notes & Library, and More!
Cardo is a standalone, browser-based tool that can be used as a simple task manager, or as a complex Project Management system (and indeed, I do use it this way in my daily work) as well as a fully Wiki-ized personal knowledge store. It runs completely independently in the browser, even without an Internet connection, making it possible to carry around on a USB stick, or to use on the morning commute.
An adaptor to enable TiddlyWiki to sync changes with a CouchDB database.
https://github.com/wshallum/couchadaptor
CouchDB sync adaptor for TiddlyWiki 5. Requires TiddlyWiki >= 5.1.2.
Works in limited testing. Not sure how well it handles conflicts.
A guide to creating a baby journal with TiddlyWiki.
http://a-penguin-in-redmond.blogspot.co.uk/2014/02/creating-baby-journal-with-tiddlywiki-5.html
Keeping a journal about your baby is fun. It allows you to keep track of those events in your baby's life and development that are most important to you, and to tell them in your own words. [...]
There are plenty of online services that can help to keep such a diary, but you need to have an internet connection to access them, and you have to trust them to keep your data safe.
A TiddlyWiki plugin for kanban-like organization in the style of Trello™ using boards, lists, and cards.
Dynamic Tables is a set of macros that allow you to create tables where the rows are created from tiddlers and the columns from the tiddler fields, or where the columns are created from tiddlers and the rows from their fields. Individual cells can be edited on the fly. Row tables can be sorted by columns and column tables can be sorted by rows.
A plugin that allows to encrypt your tiddlers individually Danielo Rodriguez.
http://danielorodriguez.com/TW5-EncryptTiddlerPlugin/
Advantages:
- You can specify a different password for each tiddler if you want.
- You don't have to encrypt your whole wiky.
- If you forget your password, you only lose a tiddler.
- It's possible to edit the tiddler content , tags and fields except the encrypt field after encryption.
- [...]
An extension for Mozilla Firefox that smoothes out some of the friction from TiddlyWiki's built-in HTML5 fallback saver, making it almost as easy to use as TiddlyFox. The workflow is intended to work out of the box, without configuration.
https://github.com/pmario/file-backups which contains links to the documentation and introduction video(s).
A chrome version is planned!
This wiki gives examples for various filters and their use in the list widget
http://tobibeer.github.io/tw/filters/#Filter%20Examples
This wiki gives examples for various filters and their use in the list widget. A good starting point to understand what filters yield which results also is test-filters.js.
The Font Awesome 5 Free SVG images collection converted to tiddlers that you can easily import (drag'n'drop) in your wiki.
An adaption of the "Ghostwriter" theme for TiddlyWiki.
https://ibnishak.github.io/ghostwriter/
Ghostwriter is a popular, minimalist and mobile responsive theme for the blogging platform ghost. This is an adaptation for TiddlyWiki.
Creates bubble maps of Biblical texts.
http://giffmex.org/gospels.bubbles.html#Gospels%20Bubbles
This TiddlyWiki, which is still under construction, has several features that together make it lightning fast to find passages, types of passages, themes, people, places and images in the New Testament Gospels. The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
- The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
- See how the different types of passages are distributed throughout each Gospel.
- Hover over passages to see the verses and titles.
- Click on a passage to open it and see the themes and other data it mentions.
- The themes by passage indexes are lists of the passages in each Gospel, followed by the themes and other data found in the passage. Clicking on a theme calls up a list of all the passages that mention that theme.
- The indexes of themes contain lists of links to each theme, person, group, place and image. Clicking on a theme calls up a list of all the passages that mention that theme.
- There is a search window hidden in the right hand menu. Use the search window to find passages quickly, by typing things like sower or paralytic. Click the arrows in the upper right of the screen to open the menu and search.
An adaptation of the TiddlyWiki powered GTD® system formerly known as MonkeyGTD for TiddlyWiki version 5.
GSD5 is a Getting-Thing-Done tool for TiddlyWiki5 based off the mGSD classic TiddlyWiki.
A collection of helpers by Thomas Elmiger, among them a tweet button macro, a text-stretch solution, a snippet extraction macro and a tiddler that installs a scroll-to-top button via drag-and-drop.
Quick Extensions for TiddlyWiki 5 – […] As I take from the community, I am happy if I can give back. You can use my stuff to do whatever you like, but remember to save a back-up first.
Thomas
A guide in Russian to creating an online shop with TiddlyWiki. No serverside code is needed, instead orders are handled by Disqus.
Tony Ching's quick guide for sharing TiddlyWiki with Google Drive.
https://googledrive.com/host/0B51gSXixfJ2Qb0I4R2M4MWJVMlU
Anyway your self-contained a non-linear personal web notebook can be hosted on Google Drive, a free cloud service from Google.com. Because TiddlyWiki5 now supports the Stanford Javascript Crypto Library (SJCL), you can encrypt your content from prying eyes (excluding the NSA of course)
An explainer about Twederation, a system of sharing information between TiddlyWiki instances.
TWederation is a system for sharing information between participating TiddlyWikis without using a client-server model. The link here points to a tiddler that gives more details. This particular implementation works something like an online forum. On the rest of the site, you can follow discussions by the developers and collaborators occurring within the Twederation "network" itself.
An extensive collection of hints and tips from Jed Carty.
http://inmysocks.tiddlyspot.com
I made this so that some of my friends with absolutely no coding experience could use some of the better features of TW5 without having to learn much. I am hopefully going to continue updating it as I learn new things. There isn't really anything here that isn't available in plenty of other places, but I figured that since I spent a while putting it together and people keep saying that TW needs more documentation I would post it here.
A step by step guide to running TiddlyWiki on a CentOS Virtual Private Server.
http://www.rosehosting.com/blog/install-and-run-tiddlywiki-on-a-centoos-6-vps-using-nginx/
In this tutorial we will guide you through the steps of installing and running TiddlyWiki on a CentOS 6 VPS.
We will also install and configure Nginx as a reverse proxy, so you can run TiddlyWiki behind Nginx.
A complete online shop made in TiddlyWiki!
A collection of extensions by @malgam
http://malsandbox.tiddlyspot.com
The "loadnew" plugin provides the JavaScript module $:/plugins/malgam/loadnew/loadnew.js that implements an incremental load command for Tiddlywiki 5.
The javascript code is based on the built-in module $:/core/modules/commands/load.js that loads tiddlers from a Tiddlywiki file into a node.js Tiddlywiki instance. This command loads all non-system tiddlers, irrespective of whether they have been modified since last loaded. As a result, all tiddlers in the node.js tiddlers folder will end up with a new modification date.
In contrast, the loadnew command only loads tiddlers that either don't already exist in the tiddlers folder, or have a newer modified date than the existing tiddler.
With a backup strategy that uses a file system snapshot process to preserve historical versions of tiddlers, the loadnew command minimises the sizes of the resulting snapshots.
Mathcell allows spreadsheet-like abilities in a completely contained TiddlyWiki.
http://mathcell.tiddlyspot.com/
Mathcell allows spreadsheet-like abilities in a completely contained TiddlyWiki. Additional abilities allow it work as a general math engine.
A Spanish guide to using TiddlyWiki on Android.
http://3palmeras.wordpress.com/2014/11/05/microblogging-con-tiddlywiki/
Tiddlywiki software is prodigious based on javascript which is capable of holding a notepad that can be edited with Internet Explorer or function as a full blog, contained in a single file.
Translation by Google Translate
An adaption of the "Moments" theme for TiddlyWiki.
http://tesseractmoments.surge.sh/
Moments is a beautiful free and responsive theme available for wordpress from here: http://www.s5themes.com/theme/moments/. This is an adaptation of the same for TW5 platform. All the design credits goes to the site and the original designer. If TW5 is going to be here for 25 years, might as well suit up.
A terrific demo of drag and drop, pan and zoom, and other sophisticated touch effects. Based on the muuri plugin by Uwe Stuehler.
NoteSelf is your personal, private, customizable, Evernote-like experience. You want cloud? Fine! You don't? Fine too! It's all yours, It's your decision! Why not be a bit selfish?
NoteSelf is the perfect place to store your ideas, notes, thoughts, tips, tricks, recipes... whatever you want to put into it! NoteSelf will store, index, and make it easily searchable, so you will find it instantly whenever you need it!
You already know and love Evernote, we know it. It is comfortable, it syncs, has search capabilities... Wow, it's almost perfect, but what about:
- Privacy - Everything is stored on the Evernote's servers!
- Customization - If you don't like the interface of Evernote, there's nothing you can do
NoteSelf is built on top of TiddlyWiki, a powerful, free, highly customizable and open-source personal wiki. We took the best of it, it's powerful customization system, and mixed it with one of the best embedded databases available, PouchDb, for bringing the synchronization capabilities you need.
A quick guide to using TiddlyWiki (written in German)
http://michaelsonntag.net/notizen-mit-tiddlywiki-systemuebergreifend-nutzen
Those using multiple different computer platforms (if only PC and Android) knows for certain: You would like to sync notes across computers and thereby be independent of any apps or services. I am concerned at any rate so and so I am constantly looking for the perfect solution.
With TiddlyWiki I found it mostly. As the name suggests, it TiddlyWiki is a Wikisystem. In contrast to all other wikis, TiddlyWiki is a single HTML file that runs in the browser and thus can be used on all modern operating systems. And because there is only one file, it can be very easily via the well-known cloud services (Dropbox, Google Drive, ownCloud) or synchronized with FTP or used on a USB stick.
(Translation from German by Google Translate)
Intérprete rápido de de Forth para el Commodore PET, escrito en lenguaje ensamblador 6502. El TiddlyWiki que contiene documentación del programa se genera automáticamente de la fuente: ver: https://github.com/chitselb/pettil.
http://chitselb.com/files/tiddlypettil.html
Los objetivos del proyecto son, sin ningún orden en particular:
- hacer un Forth que funcione en mi Commodore PET 2001
- divertirme
- desarrollar mi pericia con el "6502 assembly golf"
- encontrar otra gente interesada en este proyecto
An extension for Google Chrome and Mozilla Firefox that smoothes out some of the friction from TiddlyWiki's built-in HTML5 fallback saver, making it almost as easy to use as TiddlyFox once it is set up correctly.
Detailed description of setting up TiddlyWiki on Node.js on OS X.
http://undefinedvalue.com/2015/04/02/setting-personal-tiddlywiki-server-os-x
For a new job, I decided to set up a personal wiki to keep notes. I wanted to keep it simple, meeting these requirements:
- All the data is in a Dropbox folder (so it can be automatically synced between machines)
- It must support Markdown syntax
After looking at the options, I settled on TiddlyWiki. I've used "classic TiddlyWiki" before, and liked its simplicity, but I was always a little annoyed with the weird steps you have to go through to save changes. The new version of TiddlyWiki includes support for running it as a real HTTP server, so you can use it just like an online wiki.
But it took me a couple of hours to figure out how to set that up. The TiddlyWiki documentation is not clear ("not clear" is a euphemistic way of saying "terrible"). So, I've written up these instructions in the hope it will spare somebody else all the frustration I had.
A gamers guide to using TiddlyWiki.
http://helugame.wordpress.com/2013/09/07/shining-ark-7-using-tiddlywiki/
I’ve been using TiddlyWiki for this game mainly to record the monsters’ locations and the items that they drop. This is so that when I need a certain item to upgrade/create weapons, I can quickly look it up; which monsters drop it and which quests have those monsters.
As I play the game, as I encounter new information, I just input them into my Shining Ark TiddlyWiki. It’s like I’m building a wiki from scratch. The reason why I don’t just use online wikis is that 1) it’s too easy to get spoiled and 2) sometimes online wikis provide too much information (who cares about the non-gameplay related descriptions that can be found in the game, etc).
A collection of plugins by Stephen Kimmel, including a number of additional editor toolbar buttons.
http://skplugins.tiddlyspot.com/
In keeping with the general spirit of the TiddlyWiki community, ie, you develop something useful and/or potentially interesting you share it with others, I'm sharing some of the plugins I've developed to go with the new Editor Toolbar. You'll find them and a more extensive discussion of what each does at http://skplugins.tiddlyspot.com/
Slides and Stories is a repository of the tools to optimize TW for scientific research and for presenting and publishing results.
http://slidesnstories.tiddlyspot.com
SlidesnStories
...is a tool to save and reload sets of Tiddlers. This is already working, The aim is to develop a mechanism to transform these into instant slideshows.
MetaTabs
is a tool which gives you the possibility to attach and show specific information in tabs at the bottom of each Tiddler: ideas, notes, tasks, stories and presentations, comments, annotations and footnotes.
It is inspired by MagicTabs and Tiddlyscholar by Alberto Molina Pérez, which are very elaborated tools that alas do not seem to be in active development any more. I wanted to change the behaviour in some ways. For example I wanted show tabs only if they have content....furthermore there is
- an export-plugin,
- a footnote-plugin,
- and a plugin to rearrange Tiddlers in the StoryRiver
An enormous collection of tips beautifully curated by Tobias Beer. It is actually a collection of sites, with sub-sites dedicated to topics such as filtering (http://tobibeer.github.io/tw/filters/).
http://tobibeer.github.io/tb5/
A collection of references and sandbox for testing concepts around TiddlyWiki 5...
A Kanban implementation for TiddlyWiki with a familiar look and feel (see the demo).
https://ibnishak.github.io/Tesseract/projects/tekan/Tekan.html
This is Tekan, a TW based kanban. The easiest way to know tekan is to use it. So let us begin, shall we?
TiddlyServer is a special purpose Desktop app, designed to facilitate managing multiple instances of TiddlyWiki running as a server. It does not require internet acess to access the wikis.
https://github.com/mklauber/TiddlyServer/releases/
TiddlyServer can import both TiddlyWiki files and TiddlyFolder wikis. For each wiki, you specify a prefix to serve it with and the source to import from. It will copy the wikis to its own internal store and begin serving them up at http://localhost:8080/{prefix}/. The export button for each wiki will convert it to a single file wiki.
Reaction to TiddlyWiki5 from the translator of the German edition of TiddlyWikiClassic.
http://blog.netplanet.org/2014/01/03/tiddlywiki-5-im-betatest/
There is little software that can still inspire me so even after years, as on the first day. This includes TiddlyWiki, the "pocket-wiki". The latter is because the Wiki completely fits into an HTML file, and this HTML file brings everything - JavaScript program logic, CSS appearance and the entire Wiki content as stored records. So a TiddlyWiki file is then sometimes happy times some megabytes in size, but just has the unbeatable advantage that it works just as fast file created locally in a variety of browsers.
(Translation from German by Google Translate)
Edición de una versión anterior de TiddlyWiki, adaptada para la toma rigurosa de notas académicas.
http://tw5.scholars.tiddlyspot.com/
TiddlyWiki for Scholars es una customización personal de TiddlyWiki 5.0.13-beta que hice para tomar notas de lectura, pero que puede servir también a otros fines La idea subyacente en esta adaptación es la de poder crear y mostrar información relacionada con el tiddler que se visualiza, sin tener que salir de él para hacerlo.
A collection of tips and guides in French, introduced by this blog post:
http://sylvain.naud.in/post/2014/10/29/Ressources-pour-TiddlyWiki-5-%28FR%29
Ce guide de prise en main de TiddlyWiki vous permettra de débuter sur ce logiciel : rédiger du texte avec la syntaxe wiki, insérer des images, créer des Tiddler, faire une recherche, ajouter des fonctionnalités, et bien d'autres choses.. Bonne lecture ! Sylvain
A Knowledge Network about TiddlyWiki.
http://confocal-manawatu.pbworks.com/w/page/113574373/TiddlyWiki
Interconnected with the visual taxonomy at every node: http://debategraph.org/Stream.aspx?nid=457381&vt=bubble&dc=focus
TWKN will be transferred into TWederation/TiddlyMap format as soon as I am convinced in reliable and secure versioning and multi-user operation in TW format. Your assistance and support would be highly appreciated.
Notes and tips by a developer working on writing TiddlyWiki plugins – including TWExe, a widget for running Windows scripts and executables.
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists.
http://blog.jeffreykishner.com/tiddlywiki/
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
A topical index of known plugins, tutorials, themes, and other helpful tools for TiddlyWiki.
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Some of the topics indexed so far include:
- Background images and background colors
- Breadcrumbs
- Business - examples
- CSS / Styles, general
- Calendars, dates and timelines
- Checklists
- Collaboration
- Color palettes
- Colors
- Data visualizations
- Developer / advanced tools
- Diplay tiddlers horizontally
- Dropdowns
- Educational
- External files
- Fields
- Fonts
- Fun and games
- Home and lifestyle
- IFrames and embedding media
- Image galleries, modals and lightboxes
- Images, icons, emojis
- Importing and exporting between TiddlyWiki files
- Includes scaffolding within a tiddler, dragging to reorder tiddlers, choosing the number of columns
- Interfacing with, importing and exporting to and from other formats
- Knowledge bases, dictionaries and glossaries
- Layout/UI
- Lightboxes
- Links, linking
- Lists and filters
- Maps and geography
- Masonry, scaffolding
- Math
- MindMapping
- Mobile tools
- Music and sound
- Navigation
- node.js
- Note-taking
- Open the "filter" tab
- Partially hidden tiddlers
- Personal websites (examples)
- Presentations and slideshows
- Printing
- Project management
- Publishing and hosting TiddlyWikis on the web
- Searching tools
- Security and backup tools
- Social media, sharing, comments
- Spreadsheets and math
- Startup
- Sticky titles
- Story and screenplay creation
- Table of contents
- Tables, charts and graphs (cf data visualizations)
- Tabs
- Tags, tagging
- Task management and productivity - to do lists
- Themes
- Understanding TiddlyWiki
- Writing and editing
Dutch blog post about TiddlyWiki
https://breinbout.wordpress.com/2014/11/26/tiddlywiki/
I'm allergic to websites that are highly dependent on JavaScript. I think that JavaScript has many useful applications to add functionality to a site, but content needs to be visible if JavaScript is switched off. I use the NoScript extension for Firefox and surf with pleasure over the Internet without spontaneous things happen that I do not give permission. I love JavaScript on a short leash. More crazier maybe I'm so excited about TiddlyWiki.
(Translation from Dutch by Google Translate)
An extensive collection of tips and resources for users of TiddlyWiki in Japanese.
http://bacchus.ivory.ne.jp/bourbon/
TiddlyWikiをHTML5にしたTiddlyWiki5が正式にリリースされました。このTiddlyWiki5の使い方について、自分で試した機能を中心に解説します。
TiddlyWiki5は、非常に多機能なローカルWikiです。このブログに書いてあることは、TiddlyWiki5で出来ることのごく一部です。
Chris Hunt's detailed developer tutorials for getting started with writing widgets for TiddlyWiki.
These pages document aspects TiddlyWiki5 programming, sharing "lessons learned" to help developers to get started with TiddlyWiki5 customization and extension.
There are currently two articles in this wiki:
- A Simple Widget
- A More Complex Widget
A TiddlyWiki5 forum on Reddit.
https://www.reddit.com/r/TiddlyWiki5/
A TiddlyWiki5 forum on Reddit. As of 2016, it claims to have the most up-to-date list of plugins available for TW5.
Huge collection of customisations and tweaks from Ton Gerner.
http://tongerner.tiddlyspot.com/
I am a longtime user of TiddlyWiki Classic and still use it daily since you can't do everything in TiddlyWiki 5 (yet) ;)
I started experimenting with TW5 at the end of September 2013 (alpha10). Since I missed a few things in the layout I got used to in TiddlyWiki Classic 1, I started with modifying the layout of TW5. To share my knowledge, I made a few guides about these 'modifications'. The guides started as a non-linear personal web notebook (yeah, the subtitle of TiddlyWiki!). I started experimenting with layout things and used TW5 to document my experiments.
A wealth of hints, tips and notes about using TiddlyWiki on Node.js:
TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline.
The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web.
Also very cool is the treatment of tags as menus everywhere.
http://larigot.avarts.ionio.gr/users/iani/wikis/tw5square.html
Also available on GitHub (download and save index.html and open it in your browser).
Timimi is a Web Extension and executable for Firefox, Chrome and Chromium that allows it to save standalone TiddlyWiki files.
https://github.com/ibnishak/Timimi
This is an addon using native messaging, essentially handing over the contents to a webextension host (executable) which does the actual saving. Once installed, you can save the standalone TW from anywhere in your hard drive without any more interactions, like the original Tiddlyfox addon.
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
http://tw5magick.tiddlyspot.com/
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
Tips and guides for using TiddlyWiki.
http://techlifeweb.com/tw5tribalknowledge.html
I never used Node.js until a couple weeks ago when I wanted to try a TW5 installation on Node and expand my knowledge a bit. I figured someone else may be in the same boat so I wrote it all down
An alternative LaTeX plugin for TiddlyWiki5. It supports a wider set of LaTeX commands than KaTeX, though not as extensive as MathJax
http://tw5-texzilla.tiddlyspot.com
This plugin provides LaTeX support in TiddlyWiki5, using the TeXZilla latex parser to generate MathML.
Only Firefox and Safari support MathML at the moment, so the plugin is only useful if you're using one of these browsers. It might be possible to combine this plugin with MathJax to convert MathML to something that other browsers can understand, e.g. HTML+CSS, but I haven't tried this.
A collection of TiddlyWiki resources from Mario Pietsch, with a focus on cloud deployments. Mario also maintains the German translation of TiddlyWiki.
My name is Mario Pietsch from Austria. I'm living near Salzburg.
This page, will be the portal to my TiddlyWiki, TiddlyWeb related content.
A guide (in French) to using TiddlyWiki on the BiblioBox, a variation of the PirateBox mobile communication and file sharing system.
http://bibliobox.net/blog/post/2014/07/16/un-wiki-sur-votre-bibliobox-avec-tiddlywiki
I've known TiddlyWiki since its beginning in 2004. For personal or professional needs, I used it regularly for notepad staff in 2007 and 2012. But I admit I ignored the tool during the past two years. And then I said yesterday: but why not put TiddlyWiki on a BiblioBox? Because it is a single HTML file with javascript. In addition I knew the existence of a server version for saving online amendments.
Hand optimised from a translation by Google Translate
A collection of references for testing concepts around TiddlyWiki 5...
This is PMario's playground with ramblings about TiddlyWiki and related stuff.
It basically is a "jump off" page to various TiddlyWiki sites, that show editions, themes and plugins.
Matabele's stylish and clean system for personal task management.
This is my work in progress version of TW5, incorporating various features and ideas as and when they intrigue me. To grab any feature you may wish to try, drag the listed tiddlers across to the dropzone of an empty TiddlyWiki 5.0.10-beta
An experiment to embed interactive 3D graphics within TiddlyWiki by Jamal Wills. It is based X3DOM, an open source JavaScript library.
TiddlyWiki es una herramienta increíblemente flexible y versátil, concebida y construida de forma muy distinta a la mayoría de software. Esto puede hacerla difícil de comprender hasta ese momento en que algo hace clic y se convierte en una extensión natural de tu cerebro.
Para empezar por lo básico, TiddlyWiki es una aplicación web para la toma de notas que puedes descargar libre y gratuitamente, que puedes guardar donde quieras y adaptar del modo que desees. Úsala para escribir, organizar y compartir notas de un modo que los procesadores de texto y otras herramientas para tomar notas no pueden.
TiddlyWiki está diseñada para estructurar contenidos de modo no lineal valiéndose de StoryLists, etiquetas, enlaces y otras características. Puedes organizar y recuperar tus notas de la manera que mejor se adapte a tu forma de pensar, en lugar de sentirte encadenado a una estructura predeterminada de organización.
TiddlyWiki is designed to be non-linear, structuring content with stories, tags, hyperlinks, and other features. You can organise and retrieve your notes in ways that conform to your personal thought patterns, rather than feel chained to one preset organisational structure.
Puedes usar TiddlyWiki tanto online como sin conexión de red. Como archivo único que consultas y editas con cualquier navegador web, o puedes utilizarlo como una poderosa aplicación de Node.js, que guarda por separado cada una de tus notas.
¿Cómo hacer que TiddlyWiki trabaje para ti? Te recomendamos empezar consultando la documentación introductoria que se muestra más abajo y echar un vistazo al índice que tienes a tu disposición en la barra lateral.
También puedes seguir estas sencillas instrucciones e ir descubriendo por ti mismo a partir de ahí.
- Amable introducción
- Descubre TiddlyWiki
- Cosas que puedes hacer
- Diez motivos para cambiar
- Ejemplos
- ¿Y el original?
También hay tutoriales en video (en inglés)
Información sobre quiénes y cómo hacemos TiddlyWiki:
| purpose | calculate the absolute value of a list of numbers |
|---|---|
| input | a selection of titles |
| output | the absolute value of the input numbers |
New in: 5.1.20 See Mathematics Operators for an overview.
A plugin to integrate the Ace editor into TiddlyWiki.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
TiddlyWiki no sería posible sin el constante apoyo de la comunidad de TiddlyWiki. Su atención y feedback constante han hecho posible tener una idea precisa de qué se espera de este producto y su pasión nos ha enseñado que la inversión en ella merece la pena.
TiddlyWiki incorpora código de los siguientes proyectos OpenSource:
- The Stanford Javascript Crypto Library
- The Jasmine JavaScript Test Framework
- Normalize.css by Nicolas Gallagher
...y materiales de estos otros proyectos:
- Banderas del mundo Wikipedia
Introduction
The action-createtiddler widget is an action widget that creates new tiddlers. ActionWidgets are used within triggering widgets such as the ButtonWidget.
There are several differences from the tm-new-tiddler message:
- The new tiddler is not automatically displayed in the story river
- The title of the new tiddler is made available for subsequent operations
Content and Attributes
The action-createtiddler widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $basetitle | The initial title that will be attempted. If a tiddler with that title already exists, then a numerical counter is added to the title and incremented until it is unique |
| $savetitle | A text reference identifying a field or index into which the title of the newly created tiddler will be stored after it is created |
| $savedrafttitle | New in: 5.1.20 A text reference identifying a field or index into which the draft title associated with the newly created tiddler will be stored after it is created. This is useful when using a sequence of action widgets to create a new tiddler, put it into edit mode, and position it within the list of its parent tag |
| $timestamp | Specifies whether the timestamp(s) of the target tiddler will be updated (modified and modifier, plus created and creator for newly created tiddlers). Can be "yes" (the default) or "no" |
| {any attributes not starting with $} | Each attribute name specifies a field to be created in the new tiddler |
Examples
New button caption: <$edit-text tiddler="$:/state/new-button-caption" tag="input" default=""/>
<$button>
<$action-createtiddler $basetitle="Homemade Button" tags="$:/tags/PageControls" text={{$:/state/new-button-caption}}/>
Create non-functional page control button
</$button>Este es su aspecto:
New button caption:
Introduction
The action-deletefield widget is an action widget that deletes specified fields of a tiddler. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-deletefield widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $tiddler | The title of the tiddler whose fields are to be modified (if not provided defaults to the current tiddler) |
| $field | Optional name of a field to delete |
| {any attributes not starting with $} | Each attribute name specifies a field to be deleted. The attribute value is ignored and need not be specified |
Examples
Here is an example of a button that deletes the caption and tags fields of the current tiddler:
<$button>
<$action-deletefield caption tags/>
Delete "caption" and "tags"
</$button>Este es su aspecto:
Here is an example of a button that deletes the modified date and tags fields of the tiddler HelloThere:
<$button>
<$action-deletefield $tiddler="HelloThere" modified tags/>
Delete "modified" and "tags" from ~HelloThere
</$button>Este es su aspecto:
Here is an example of a button that uses the optional $field attribute to delete the text field of the tiddler HelloThere:
<$button>
<$action-deletefield $tiddler="HelloThere" $field="text"/>
Delete text from ~HelloThere
</$button>Este es su aspecto:
Introduction
The action-deletetiddler widget is an action widget that deletes tiddlers. ActionWidgets are used within triggering widgets such as the ButtonWidget.
There are several differences compared to the WidgetMessage: tm-delete-tiddler:
- The user is not prompted to confirm the deletion
- No automatic updating of the story list
- No special handling of draft tiddlers
Content and Attributes
The action-deletetiddler widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $tiddler | Optional title of the tiddler to be deleted |
| $filter | Optional filter identifying tiddlers to be deleted |
Examples
Here is an example of a button that deletes the tiddler HelloThere:
<$button>
<$action-deletetiddler $tiddler="HelloThere"/>
Delete "~HelloThere"
</$button>Este es su aspecto:
Here is an example of a button that deletes all tiddlers tagged TableOfContents:
<$button>
<$action-deletetiddler $filter="[tag[TableOfContents]]"/>
Delete tiddlers tagged "~TableOfContents"
</$button>Este es su aspecto:
Introduction
The action-listops widget is an action widget that manipulates user lists in any field or data index. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-listops widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $tiddler | The title of the tiddler whose lists are to be modified (if not provided defaults to the current tiddler |
| $field | The name of a field to be manipulated as a list (defaults to 'list') |
| $index | Optional index of a property in a data tiddler index to be manipulated as a list |
| $filter | An optional filter expression, the output of which will be saved to the field/index being manipulated |
| $subfilter | An optional subfilter expression, which takes the list being manipulated as input, and saves the modified list back to the field/index being manipulated |
| $tags | An optional subfilter expression, which takes the 'tags' field of the target tiddler as input, and saves the modified list of tags back to the 'tags' field |
Extended Filter Operators
A number of extended filter operators are necessary for the manipulation of lists. These operators have been designed primarily for use in subfilter expressions whereby the modified current list is returned in place of the current list.
| Listops Operators | ||
|---|---|---|
| Operator | Purpose | |
| allafter | discard all items except those after the marker | |
| allbefore | discard all items except those before the marker | |
| append | append a range of items from an array to the list | |
| insertbefore | insert an item T into a list immediately before an item B |
|
| move | move marker N places in the list | |
| prepend | prepend a range of items from an array to the list | |
| putafter | move N trailing items after the marker | |
| putbefore | move N trailing items before the marker | |
| putfirst | move N trailing items to the head of the list | |
| putlast | move N leading items to the tail of the list | |
| remove | remove a list of titles specified in the operand from the input | |
| replace | replace marker with N trailing items | |
| sortby | sort the current list in the order of the list referenced in the operand | |
Examples
In this example we shall populate and then clear a list in an ordinary field (myfield) of this tiddler (the default.)
<$button>
<$action-listops $field="myfield" $subfilter="efg hlm pqr"/>
Populate 'myfield'
</$button>
<$button>
<$action-listops $field="myfield" $subfilter="abc xyz"/>
Append More Items
</$button>
<$button>
<$action-listops $field="myfield" $subfilter="-abc -hlm"/>
Remove Items
</$button>
<$button>
<$action-listops $field="myfield" $filter="[[]]"/>
Clear 'myfield'
</$button>
<$list filter="[list[!!myfield]]">
</$list>Este es su aspecto:
In this example we shall append and remove items from a list in an ordinary field (myfield) of this tiddler (the default) and sort the resultant list. We shall then remove some of the appended items and sort the resulting list in reverse order.
<$button>
<$action-listops $field="myfield" $subfilter="-efg ijk xyz [[this is a title]] +[sort[]]"/>
Mangle List
</$button>
<$button>
<$action-listops $field="myfield" $subfilter="-xyz -[[this is a title]] +[!sort[]]"/>
Unmangle List
</$button>
<$list filter="[list[!!myfield]]">
</$list>Este es su aspecto:
In this example we shall append a few tags to the 'tags' field of this tiddler (the default.) We shall then remove some of the appended tags.
<$button>
<$action-listops $tags="+[append{Days of the Week!!short}] $:/tag1 $:/tag2 $:/tag3"/>
Populate 'tags'
</$button>
<$button>
<$action-listops $tags="+[!remove:2{!!tags}]"/>
Remove Last Two Tags
</$button>
<$button>
<$action-listops $tags="+[!prefix[$:/]]"/>
Remove System Tags
</$button>
<$button>
<$action-listops $tags="-Mon -Tue"/>
Remove Mon and Tue
</$button>
<$button>
<$action-listops $tags="+[prefix[$:/]] ActionWidgets Widgets"/>
Remove User Tags
</$button>
<$button>
<$action-listops $tags="+[[]] ActionWidgets Widgets"/>
Clear Tags
</$button>
<$list filter="[list[!!tags]]">
</$list>Este es su aspecto:
Introduction
The action-navigate widget is an action widget that sends a tm-navigate message back up the widget tree. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-navigate widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $to | The title of the target tiddler for the navigation (if not provided defaults to the current tiddler |
| $scroll | Optional parameter determining whether the navigation will also cause a scroll to the target tiddler (see below) |
Scroll handling
The optional $scroll attribute can be set to "yes" to force scrolling to occur to bring the target tiddler into view. If set to "no" then scrolling does not occur. If the $scroll attribute is omitted then scrolling occurs unless either:
- the control key is pressed
- the action was initiated with the middle mouse button (if available)
Note that if navigating to multiple tiddlers at once you should use the same $scroll setting for all of them.
Examples
Here is an example of button that navigates to two different tiddlers at once:
<$button>
<$action-navigate $to="ButtonWidget"/>
<$action-navigate $to="ActionWidgets"/>
Click me!
</$button>Este es su aspecto:
Introduction
The action-sendmessage widget is an action widget that sends a message back up the widget tree. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-sendmessage widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $message | The message to send (eg, WidgetMessage: tm-new-tiddler) |
| $param | Optional parameter string whose meaning is dependent on the message being sent |
| $name | Optional name of additional parameter |
| $value | Value for optional parameter whose name is specified in $name |
| {any attributes not starting with $} | Multiple additional, optional named parameters that are attached to the message |
Examples
Here is an example of button that displays both a notification and a wizard, and creates a new tiddler with tags and text:
<$button>
<$action-sendmessage $message="tm-modal" $param="SampleWizard"/>
<$action-sendmessage $message="tm-notify" $param="SampleNotification"/>
<$action-sendmessage $message="tm-new-tiddler" title="This is newly created tiddler" tags="OneTag [[Another Tag]]" text=<<now "Today is DDth, MMM YYYY">>/>
Click me!
</$button>Este es su aspecto:
Introduction
The action-setfield widget is an action widget that assigns values to the fields of a tiddler. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-setfield widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $tiddler | The title of the tiddler whose fields are to be modified (if not provided defaults to the current tiddler) |
| $field | Optional name of a field to be assigned the $value attribute |
| $index | Optional index of a property in a data tiddler to be assigned the $value attribute |
| $value | The value to be assigned to the field or index identified by the $field or $index attribute. If neither is specified then the value is assigned to the text field. If no value is specified, $field or $index will be deleted. |
| $timestamp | Specifies whether the timestamp(s) of the target tiddler will be updated (modified and modifier, plus created and creator for newly created tiddlers). Can be "yes" (the default) or "no" |
| {any attributes not starting with $} | Each attribute name specifies a field to be modified with the attribute value providing the value to assign to the field |
Examples
Here is an example of a pair of buttons that open the control panel directly to specified tabs. They work by using action-setfield to set the state tiddler for the control panel tabs.
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Appearance"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Appearance" tab
</$button>
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Settings"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Settings" tab
</$button>Este es su aspecto:
Here is an example of a button that assigns tags and fields to the tiddler HelloThere, and then navigates to it and opens the tiddler info panel on the "Fields" tab:
<$button>
<$action-setfield $tiddler="HelloThere" tags="NewTag [[Another New Tag]]" color="red"/>
<$action-setfield $tiddler="$:/state/popup/tiddler-info--1779055697" text="(568,1443,33,39)"/>
<$action-setfield $tiddler="$:/state/tab--1890574033" text="$:/core/ui/TiddlerInfo/Fields"/>
<$action-navigate $to="HelloThere"/>
Modify ~HelloThere
</$button>Este es su aspecto:
Here is an example of a button that assigns tags and fields to the tiddler HelloThere, and then initiates editing it:
<$button>
<$action-setfield $tiddler="HelloThere" tags="MoreTag [[Further More Tags]]" color="green"/>
<$action-sendmessage $message="tm-edit-tiddler" $param="HelloThere"/>
Edit ~HelloThere
</$button>Este es su aspecto:
Here is an example of a button that opens the control panel directly to the "Appearance" tabs:
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" $field="text" $value="$:/core/ui/ControlPanel/Appearance"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Appearance" tab
</$button>Este es su aspecto:
The variable actionTiddler is used in subtly different ways by different widgets:
- Within the actions string of the DroppableWidget, the actionTiddler variable contains the title of the tiddler being dropped.
- Within the startactions and endactions string of the DroppableWidget, the actionTiddler variable contains a quoted Title List of all of the titles being dragged.
Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that trigger those actions (for example, the ButtonWidget).
The following action widgets are provided:
- action-createtiddler
- action-deletefield
- action-deletetiddler
- action-listops
- action-navigate
- action-sendmessage
- action-setfield
There are two ways to use action widgets:
- Using the
actionsattribute of the triggering widget (this is the preferred way) - Embedding the actions within the triggering widget (an older technique that is now deprecated)
Assigning action widgets with the actions attribute
The action widgets are passed as a string to the actions attribute of the triggering widget. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
\define my-actions()
<$action-sendmessage $message="tm-home"/>
<$action-sendmessage $message="tm-full-screen"/>
\end
<$button actions=<<my-actions>>>
Click me!
</$button>Assigning action widgets by embedding
The action widgets need not be immediate children of their triggering widget, but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
<$button>
<$action-sendmessage $message="tm-home"/>
<$action-sendmessage $message="tm-full-screen"/>
Click me!
</$button>| purpose | treating each input title as a number, add to each the numeric value of the operand |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers, but with N added to each one |
New in: 5.1.20 See Mathematics Operators for an overview.
Es posible añadir una tabla de contenidos a la barra lateral, siguiendo estos pasos:
- Crea un tiddler llamado TableOfContents
- Etiquétalo como
$:/tags/SideBar - En el cuerpo del tiddler, escribe el siguiente texto:
<div class="tc-table-of-contents"> <<toc-selective-expandable 'TableOfContents'>> </div> - Añade el campo
captioncon el texto Contenidos o la referencia adecuada a un tiddler o variable. p. ej, en el caso de la tabla de contenidos de este wiki,captiontoma su valor del contenido de$:/language/SideBar/Contents/Caption. - Añade el campo
con el valor "$:/core/ui/SideBar/Open" para que la pestaña de de contenidos se muestre inmediatamente después de la de Abiertos
Añade entradas a la tabla de contenidos creando tiddlers con la etiqueta TableOfContents. Una forma sencilla de hacerlo es con el botón del desplegable . De igual modo, a partir de estas, se pueden crear subentradas etiquetadas con el nombre de la entrada del nivel superior.
The standard mechanisms in TiddlyWiki for creating Table-of-Contents are macros known collectively as "toc" macros (click on link to learn more about macros). They use Tagging as their means of creating relationships, so be sure to review the Tagging topic tiddler if tagging is a new concept for you.
A customisable table of contents can be added to the sidebar with the following steps:
- Create a tiddler called TableOfContents
- Give it the tag $:/tags/SideBar
- Set the text to
<div class="tc-table-of-contents"> <<toc-selective-expandable 'TableOfContents'>> </div> - Add a caption field with the text Contents
- Add a list-after field with the text $:/core/ui/SideBar/Open
Add entries to the table of contents by creating tiddlers tagged TableOfContents. An easy way is to choose new here from the tiddler toolbar of the TableOfContents tiddler. (if you don't see the "new here" button, click on the down arrow to see more menu options.)
To create child tiddlers (tiddlers that come below other tiddlers), tag them with the name of the parent tiddler.
Esta es una macro para crear el botón "Seguir en Twitter" para seguir una cuenta en particular:
\define twitterFollowButton(username)
<iframe allowtransparency="true" frameborder="0" scrolling="no" src="//platform.twitter.com/widgets/follow_button.html?screen_name=$username$" style="width:300px; height:20px;"></iframe>
\endEl único cambio respecto de la versión publicada en https://dev.twitter.com/docs/follow-button es que se han eliminado las nuevas líneas.
Ten en cuenta que "src URL" aparece sin protocolo (o sea, "http" o "https"). Se hace así para que funcione en sitios alojados tanto en uno como en otro. Si quieres que el botón de Twitter funcione mientras manejas TiddlyWiki offline como "file://", tendrás que añadir el protocolo manualmente. Por ejemplo:
<iframe allowtransparency="true" frameborder="0" scrolling="no" src="http://platform.twitter.com/widgets/follow_button.html?screen_name=jermolene" style="width:300px; height:20px;"></iframe>No todos los navegadores soportan las últimas características de ES2015. El proyecto Babel ofrece un polyfill que puede incluirse en TiddlyWiki, de modo que dichas características estén disponibles para nuevos plugins. Para hacerlo, es necesaria una copia del código fuente del polyfill.
Puede obtenerse una copia a través de npm o se puede descargar desde la página del proyecto. En la documentación del polyfill de Babel existe información específica para su instalación.
Hay que crear una carpeta plugins/babel-polyfill dentro de la carpeta editions de TiddlyWiki. En ella hay que crear el documento plugins/babel-polyfill/plugin.info, con el siguiente contenido:
{
"title": "$:/plugins/babel/babel-polyfill",
"description": "Babel Polyfills for ES2015 support",
"author": "Your Name Here",
"core-version": ">=5.0.0"
}Crea la carpeta plugins/babel-polyfill/files. Dentro, el archivo plugins/babel-polyfill/files/tiddlywiki.files, con el siguiente contenido:
{
"tiddlers": [
{
"file": "polyfill.min.js",
"fields": {
"title": "$:/plugins/babel/babel-polyfill/polyfill.min.js",
"type": "application/javascript",
"module-type": "library",
"global-module": "true"
}
}
]
}Copia entonces el archivo polyfill.min.js que ya has descargado.
Por último, necesitarás un inicializador, para lo que deberás crear el archivo plugins/babel-polyfill/plugin.js, con el siguiente contenido:
/*\
title: $:/plugins/babel/babel-polyfill/plugin.js
type: application/javascript
module-type: startup
Load the babel-polyfill library on startup
\*/
exports.startup = function() {
$tw.modules.execute('$:/plugins/babel/babel-polyfill/polyfill.min.js');
}Ahora están disponibles todas las características del entorno de ejecución ES2015.
En Escribir plugins con ES2016 está disponible la información necesaria sobre la sintaxis de ES2015 para programar plugins.
| purpose | extend each input title with a prefix |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | the input, but with S added to the start of each title |
| purpose | extend each input title with a suffix |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | the input, but with S added to the end of each title |
Mantener la coherencia entre títulos de tiddler puede volverse más y más difícil a medida la estructura de tu TiddlyWiki se vuelve más y más compleja. Por ejemplo: ¿Hay que referirse a términos en plural o en singular? ¿En CamelCase o separando palabras? ¿Con mayúscula sólo al principio o Con Mayúscula En Cada Palabra? ¿Traducimos los términos en inglés o los incorporamos a nuestra terminología?
Redactar formalmente una política de estilos puede ser de gran ayuda para reducir toda posible confusión. Por ejemplo, la Guía de estilo de este TiddlyWiki.
Tiddlers de sistema
Una convención que te resultará útil es la de usar el prefijo $:/_para todo nuevo tiddler de sistema que crees, porque así te aseguras de que aparezca al principio de las listas, por ejemplo, la lista de tiddlers de sistema de la barra lateral en la pestaña Más/Sistema.
| purpose | find which input title follows a specified one |
|---|---|
| input | a selection of titles |
| parameter | T = one of those titles |
| output | the title that immediately follows T in the input |
If T is not present in the input, or is the last title there, then the output is empty.
These examples make use of the Days of the Week tiddler. The Thursday tiddler shows a further example.
[list[Days of the Week]after[Monday]]
[list[Days of the Week]after[Sunday]]
Las alertas se muestran como cajas amarillas superpuestas a la ventana principal de TiddlyWiki. Cada una corresponde a un tiddler con la etiqueta <<.tag $:/tags/Alert]]. Pinchando el icono de la papelera en una alerta borra el tiddler correspondiente.
Aquí va una demostración: .
Los tiddlers de alerta contienen los siguientes campos:
| Campo | Descripción |
|---|---|
| title | Por defecto, con el prefijo $:/temp/alerts/ |
| text | Texto de la alerta |
| modified | Fecha y hora de la alerta (para ordenarlos en pantalla) |
| component | Componente asociado a la alerta |
| tags | Deben incluir $:/tags/Alert |
| purpose | find all titles of a fundamental category |
|---|---|
| input | ignored, unless the parameter is empty |
| parameter | zero or more categories |
| output | the titles that belong to all the specified categories |
The parameter specifies zero or more fundamental categories using the following syntax:
| Category | Members | Sorted |
|---|---|---|
current | just the current tiddler | – |
missing | all non-existent tiddlers to which there is at least one hard link | no |
orphans | all tiddlers to which there are no hard links | by title |
shadows | all the shadow tiddlers that exist, including any that have been overridden with non-shadow tiddlers | no |
tags | all the tags in use on non-shadow tiddlers | no |
tiddlers | all the non-shadow tiddlers that exist | no |
If the parameter specifies more than one category, they are processed from left to right. The overall output is initially empty, and each category's output is dominantly appended to it in turn. Unrecognised categories contribute nothing to the output.
As a special case, if the parameter is empty, the output is simply a copy of the input. This can be useful when the parameter is soft.
The is operator is similar, but its scope is restricted to its input.
[all[shadows]]
[all[shadows+tiddlers]]
[all[tiddlers+shadows]]
[all[orphans+missing+current]]
[all[current]]
[all[current]tag[Operator Examples]]
[all[current]tag[Recipes]]
Monday Thursday +[all[]]
| purpose | discard all items except those after the marker |
|---|---|
| input | a list of items |
| suffix | specifying a suffix ('include') will include the marker in the output |
| parameter | marker = the list item to be used as a marker |
| output | all items after the marker |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[allafter[Wednesday]]
[list[Days of the Week]] +[allafter:include[Wednesday]]
| purpose | discard all items except those before the marker |
|---|---|
| input | a list of items |
| suffix | specifying a suffix ('include') will include the marker in the output |
| parameter | marker = the list item to be used as a marker |
| output | all items before the marker |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]allbefore[Wednesday]]
[list[Days of the Week]allbefore:include[Wednesday]]
Current tiddlers:
Here are the details of the alpha releases of TiddlyWiki5. See TiddlyWiki5 Versioning for details of how releases are named.
Release 5.0.1-alpha
Released 6 diciembre 2013 at 17:53
See GitHub for detailed change history of this release
Improvements
- Changes to the importing process to enable a smoother Upgrading process
- Ignores attempts to import plugins that are older than currently installed plugins
- System tiddlers are now imported as usual
- If
$:/themeisn't defined or refers to a missing tiddler, then fallback through Snow White to Vanilla. This means thatempty.htmlnow defaults to Snow White - Added support for Block Quotes in WikiText
- Contributed by StephanHradek (@Skeeve on GitHub)
Bug fixes
- Fixed bug that was preventing
$:/tags/PageControlstiddlers from being reordered
Internal changes
- Changed the TiddlyWiki5 Versioning policy
- Beta releases will be
5.0.x-betaand the final release will be5.1.x
- Beta releases will be
The Amazon Web Services Plugin provides several tools for working with Amazon Web Services:
- Templates for saving a TiddlyWiki as a single JavaScript file in a ZIP file that can be executed as an AWS Lambda function. In this form, TiddlyWiki is a self contained single file containing both code and data, just like the standalone HTML file configuration
- Commands that can be used to interact with AWS services, under both the Node.js and Lambda configurations of TiddlyWiki
| purpose | append a range of items from an array to the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to all |
| parameter | list = the array of items to be appended to the tail of the list |
| output | a list with items appended from the head of the operand array |
! output | a list with items appended from the tail of the operand array |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]append[Tomorrow]]
[list[Days of the Week]append[Yesterday Today Tomorrow]]
- Append the first 4 short days of the week to our list
[list[Days of the Week]append:4{Days of the Week!!short}]
Estos son algunos artículos recientes publicados sobre TiddlyWiki.
Envía nuevos artículos que encuentres via GitHub o Twitter, o publícalas en el grupo
"A free, open source wiki revisited" by Mark Gibbs, NetworkWorld
Interesting article giving the perspective of someone who has been away from TiddlyWiki for a few years:
Way back in the mists of time (actually, January 2009) I wrote about a really cool tool called TiddlyWiki, a “non-linear personal web notebook”. Fast forward to today and I just had an out of body experience: Completely by accident I found a TiddlyWiki that I started when I wrote that piece and it still works!
Finding code that works flawlessly after just two or three years is magical enough but after seven years?! And given that TiddlyWiki is written as a single page Web application and considering how different browsers are now than they were in 2009, the fact that the old version of TiddlyWiki still works is not short of miraculous.
"Setting Up a Personal TiddlyWiki Server on OS X" by Kris Johnson
Detailed description of setting up TiddlyWiki on Node.js on OS X.
http://undefinedvalue.com/2015/04/02/setting-personal-tiddlywiki-server-os-x
For a new job, I decided to set up a personal wiki to keep notes. I wanted to keep it simple, meeting these requirements:
- All the data is in a Dropbox folder (so it can be automatically synced between machines)
- It must support Markdown syntax
After looking at the options, I settled on TiddlyWiki. I've used "classic TiddlyWiki" before, and liked its simplicity, but I was always a little annoyed with the weird steps you have to go through to save changes. The new version of TiddlyWiki includes support for running it as a real HTTP server, so you can use it just like an online wiki.
But it took me a couple of hours to figure out how to set that up. The TiddlyWiki documentation is not clear ("not clear" is a euphemistic way of saying "terrible"). So, I've written up these instructions in the hope it will spare somebody else all the frustration I had.
"TiddlyWiki" by Sander de Boer
Dutch blog post about TiddlyWiki
https://breinbout.wordpress.com/2014/11/26/tiddlywiki/
I'm allergic to websites that are highly dependent on JavaScript. I think that JavaScript has many useful applications to add functionality to a site, but content needs to be visible if JavaScript is switched off. I use the NoScript extension for Firefox and surf with pleasure over the Internet without spontaneous things happen that I do not give permission. I love JavaScript on a short leash. More crazier maybe I'm so excited about TiddlyWiki.
(Translation from Dutch by Google Translate)
"Notizen mit TiddlyWiki systemübergreifend nutzen" by Michael Sonntag
A quick guide to using TiddlyWiki (written in German)
http://michaelsonntag.net/notizen-mit-tiddlywiki-systemuebergreifend-nutzen
Those using multiple different computer platforms (if only PC and Android) knows for certain: You would like to sync notes across computers and thereby be independent of any apps or services. I am concerned at any rate so and so I am constantly looking for the perfect solution.
With TiddlyWiki I found it mostly. As the name suggests, it TiddlyWiki is a Wikisystem. In contrast to all other wikis, TiddlyWiki is a single HTML file that runs in the browser and thus can be used on all modern operating systems. And because there is only one file, it can be very easily via the well-known cloud services (Dropbox, Google Drive, ownCloud) or synchronized with FTP or used on a USB stick.
(Translation from German by Google Translate)
"TiddlyWiki 5 im Betatest" by besim
Reaction to TiddlyWiki5 from the translator of the German edition of TiddlyWikiClassic.
http://blog.netplanet.org/2014/01/03/tiddlywiki-5-im-betatest/
There is little software that can still inspire me so even after years, as on the first day. This includes TiddlyWiki, the "pocket-wiki". The latter is because the Wiki completely fits into an HTML file, and this HTML file brings everything - JavaScript program logic, CSS appearance and the entire Wiki content as stored records. So a TiddlyWiki file is then sometimes happy times some megabytes in size, but just has the unbeatable advantage that it works just as fast file created locally in a variety of browsers.
(Translation from German by Google Translate)
- [attr]
- Represents an element with an attribute name of attr.
- [attr="value"]
- Represents an element with an attribute name of attr and whose value is exactly "value".
- [attr~="value"]
- Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
- [attr|="value"]
- Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
- [attr^="value"]
- Represents an element with an attribute name of attr and whose first value is prefixed by "value".
- [attr$="value"]
- Represents an element with an attribute name of attr and whose last value is suffixed by "value".
- [attr*="value"]
- Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
- [attr "operator value" i]
- Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
Learn more at: Attribute selectors - CSS or CSS-Specification
Se pueden incorporar archivos de audio a TiddlyWiki de manera muy similar a como se hace con imágenes.
Audio incrustado
Se pueden incrustar pequeños archivos de audio directamente en TiddlyWiki. No es conveniente hacerlo con archivos grandes (de más de unos pocos cientos de Kb), porque aumenta el tamaño del archivo de ~Tiddlywiki.
Veamos un ejemplo: el tiddler TiddlyWiki.mp3 contiene la grabación de la palabra "TiddlyWiki" en inglés. Si abres el tiddler, verás un pequeño reproductor de audio que te permitirá oirlo.
Por supuesto, como ocurre con cualquier otro tiddler, puedes hacer la transclusión de su contenido:
{{TiddlyWiki.mp3}}Este es su aspecto:
Audio externo
Un tiddler de audio externo usa el campo _canonical_uri para apuntar al origen externo de un archivo o stream de audio y bloquear el campo Text. Esto reduce considerablemente su tamaño a la vez que nos sigue permitiendo su reproducción.
Otro ejemplo: el tiddler Caruso - Ave Maria apunta a un archivo online almacenado en http://archive.org:
{{Caruso - Ave Maria}}Este es su aspecto:
Si hay un SaverModule disponible que lo permita, TiddlyWiki guardará el documento en su estado actual en cuanto se pulsen los botones o
Debieras ver entonces una notificación amarilla en la esquina superior derecha de la ventana que confirma que se ha realizado el guardado.
Se puede activar y desactivar el guardado automático en la pestaña Configuración del panel de control. Entre bambalinas, se controla mediante el tiddler de configuración $:/config/AutoSave, que en su cuerpo indica con los valores Sí o No si activa el autoguardado.
| purpose | find the titles that link to each input title |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | any non-system titles that contain hard links to the input titles |
Each input title is processed in turn. The corresponding tiddler's list of backlinks is generated, sorted alphabetically by title, and then dominantly appended to the operator's overall output.
[[HelloThere]backlinks[]]
[all[current]backlinks[]]
From Beaker Browser website:
Beaker is a Peer-to-Peer Web Browser, made for users to run applications independently of hosts. Using P2P Hypermedia, Beaker separates frontend apps from backend services, so that users are completely in control of their software and data. Read more.
Beaker is a fork of the open source Chromium browser (which is the core engine powering Google's Chrome browser).
Beaker adds the ability to host sites within the browser, and browse to those sites via the dat:// protocol. The extraordinary thing is that if you are running Beaker then you can also browse to sites hosted by other users, without needing any server in between.
Further, you can opt to host a site belonging to somebody else, forming part of a Bittorrent-like swarm of peers serving the content to other browsers. You can also fork a site, making your own copy that you can change as you need.
The main disadvantage is that mainstream browsers cannot use dat:// sites.
Most of the magic is accomplished by the underlying Dat protocol.
New in: 5.1.14 TiddlyWiki incorporates a special saver module permitting changes to be saved directly from Beaker browser. See Saving on Beaker Browser for instructions.
| purpose | find which input title precedes a specified one |
|---|---|
| input | a selection of titles |
| parameter | T = one of those titles |
| output | the title that immediately precedes T in the input |
If T is not present in the input, or is the first title there, then the output is empty.
These examples make use of the Days of the Week tiddler. The Thursday tiddler shows a further example.
[list[Days of the Week]before[Saturday]]
[list[Days of the Week]before[Monday]]
Here are the details of the beta releases of TiddlyWiki5. See TiddlyWiki5 Versioning for details of how releases are named.
Release 5.0.18-beta
Released 17 septiembre 2014 at 21:10
See GitHub for detailed change history of this release
This is a minor release prior to the full release of TiddlyWiki on September 20th. The documentation has been cleaned up and improved (with more improvements to come).
File Layout of tiddlywiki.com
The layout of files on tiddlywiki.com has been adjusted to make it more logical. See the ticket for a discussion. You can see the source files that make up tiddlywiki.com at https://github.com/Jermolene/jermolene.github.com
Hackability Improvements
- Added first iteration of a
list-linksmacro (further improvements are planned) - Added support for importing
.markdownand.mdfiles - Extended
timelinemacro to support a subfilter
Bug Fixes
- Fixed problem with digits being classified as lower case letters for wiki link matching
- Fixed crash when sorting missing tiddlers by fields other than title
- Fixed problem with handling
.jpegfile extensions - Fixed problem with RadioWidget and missing tiddlers
- Fixed problem with dragging a partially selected link
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
There are two ways to produce HTML block quotes in TiddlyWiki5, one for content spread across multiple lines, and one for single line content.
Multi-line Block Quotes
The syntax for multi-line block quotes () is:
<<<
This is a block quoted paragraph
written in English
<<<
Tiene este aspecto:
This is a block quoted paragraph written in English
... y su código HTML es:
<blockquote class="tc-quote"><p>This is a block quoted paragraph written in English </p></blockquote>
Citation
A citation can be added to the quote like this:
<<<
Computers are like a bicycle for our minds
<<< Steve Jobs
Tiene este aspecto:
Computers are like a bicycle for our minds
Steve Jobs
... y su código HTML es:
<blockquote class="tc-quote"><p>Computers are like a bicycle for our minds </p><cite>Steve Jobs</cite></blockquote>
CSS Classes
CSS classes can be added to a block quote:
<<<.myClass.another-class
Operating systems are like a brick wall for our minds
<<< Nobody
Tiene este aspecto:
Operating systems are like a brick wall for our minds
Nobody
... y su código HTML es:
<blockquote class="tc-quote myClass another-class"><p>Operating systems are like a brick wall for our minds </p><cite>Nobody</cite></blockquote>
The core includes the class tc-big-quote that renders block quotes with outsize double quotes:
<<<.tc-big-quote
A dramatic quote
<<< Somebody Important
Tiene este aspecto:
A dramatic quote
Somebody Important
... y su código HTML es:
<blockquote class="tc-quote tc-big-quote"><p>A dramatic quote </p><cite>Somebody Important</cite></blockquote>
Single-line Block Quotes
The single-line syntax for block quotes is actually an extension of the syntax for Lists in WikiText. For example:
> Quoted text
> Another line of quoted text
Tiene este aspecto:
Quoted text
Another line of quoted text
... y su código HTML es:
<blockquote><p>Quoted text</p><p>Another line of quoted text</p></blockquote>
You can also nest quotes like this:
> A top quote
>> A subquote
> Another top quoteWhich renders as:
A top quote
A subquote
Another top quote
You can also mix block quotes with other list items. For example:
* List One
** List Two
**> A quote
**> Another quote
* List Three
Tiene este aspecto:
- List One
- List Two
A quote
Another quote
- List Two
- List Three
... y su código HTML es:
<ul><li>List One<ul><li>List Two<blockquote><p>A quote</p><p>Another quote</p></blockquote></li></ul></li><li>List Three</li></ul>
Desarrollada para su uso en Node.js, la edición "blog" de TiddlyWiki contiene herramientas para la publicación de blogs estáticos en HTML.
Mientras se prepara la documentación, puedes ver un ejemplo de su uso en http://jermolene.com/
TiddlyWiki ha sido diseñado para trabajar en navegadores compatibles con HTML5.
La tabla siguiente es un resumen de versiones de los navegadores en los que se sabe que TiddlyWiki funciona correctamente:
| Navegador | Status |
|---|---|
| Internet Explorer | Versión 10 y superiores |
| Chromium/Chrome | Todas las recientes |
| Firefox | Todas las recientes |
| Firefox for Android | Todas las recientes |
| Safari | Versión 6 y superiores |
The BrowserStorage Plugin enables TiddlyWiki to save tiddlers in browser local storage. This means that changes are stored within the browser, and automatically re-applied any time the base wiki is reloaded.
Browser local storage is not a panacea for TiddlyWiki:
- Browsers limit the amount of local storage available to a page, typically to 5 or 10MB
- Keeping personal data in browser local storage can lead to unexpected privacy violations
- Browsers reserve the right to without warning delete data stored in local storage at any time
- Browsers tie local storage to a URL which can lead to problems if you move a wiki to a URL previously occupied by a different wiki
Please use this plugin with caution. There are a number of unresolved issues and open questions.
The BrowserStorage Plugin can be installed from the plugin library.
Introduction
The browse widget displays an HTML file browser button that allows the user to choose one or more files to import. It sends a WidgetMessage: tm-import-tiddlers carrying a JSON representation of the tiddlers imported from the files up through its parents. This message is usually handled by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.
Content and Attributes
The content of the <$browse> widget is ignored.
| Attribute | Description |
|---|---|
| multiple | Set to "multiple" to select multiple file upload |
| deserializer | New in: 5.1.15 Optional name of deserializer to be used (by default the deserializer is derived from the file extension or type) |
| tooltip | Optional tooltip text |
| message | Optional override of widget message to be generated. The parameter for the message will be the JavaScript object event.target.files |
On iPhone/iPad choosing the multiple option will remove the ability to take photographs/videos directly into TiddlyWiki.
e.g.
<$browse>renders as:
BT (née British Telecom) is the UK's largest telecommunications company. In 2007, Osmosoft was acquired by BT. JeremyRuston subsequently left BT in 2011.
Compila los targets que se especifican.
Si no se especifica ninguno, se incluirán todos los disponibles
--build <target> [<target> ...]Los targets se definen en el archivo tiddlywiki.info
See TiddlyWikiFolders for details of defining build targets.
TiddlyWiki5 can be used to build older 2.x.x versions of TiddlyWikiClassic from their constituent components. Doing so involves these features:
- The
tiddlywiki/classictoolsplugin, containing a deserializer module which allows tiddlers to be loaded from TiddlyWiki 2.x.x.recipefiles - The
stripcommentsformat for the ViewWidget, which strips single line JavaScript comments starting//# - The
stripTitlePrefix='yes'attribute of the FieldsWidget, which removes prefixes wrapped in curly braces from thetitleattribute- For example,
{tiddler}HelloTherewould be transformed toHelloThere
- For example,
Usage
TiddlyWikiClassic is built from the command line by running TiddlyWiki on Node.js. A typical usage would be:
node ../../tiddlywiki.js \
--verbose \
--load <path_to_recipe_file> \
--rendertiddler $:/core/templates/tiddlywiki2.template.html <path_to_write_index_file> text/plain \
|| exit 1| purpose | discard the last N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | all but the last N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]butlast[]]
[list[Days of the Week]butlast[2]]
A B C D E F G H I J K L M +[butlast[7]]
Introduction
The button widget displays an HTML <button> element that can perform a combination of optional actions when clicked:
- Executing any ActionWidgets passed in the
actionsattribute - Executing any ActionWidgets that are immediate children of the button widget
- Execute any integrated actions:
- Navigate to a specified tiddler
- Dispatch a user defined widget message
- Trigger a user defined popup
- Assign new text to a specified tiddler
The integrated actions are provided as a shortcut for invoking common actions. The same functionality is available via ActionWidgets, with the exception of the support for highlighting selected popups.
Content and Attributes
The content of the <$button> widget is displayed within the button.
| Attribute | Description |
|---|---|
| actions | A string containing ActionWidgets to be triggered when the key combination is detected |
| to | The title of the tiddler to navigate to |
| message | The name of the widget message to send when the button is clicked |
| param | The optional parameter to the message |
| set | A TextReference to which a new value will be assigned |
| setTitle | A title to which a new value will be assigned, without TextReference. Gets preferred over state |
| setField | A field name to which the new value will be assigned, if the attribute stateTitle is present. Defaults to the text field |
| setIndex | An index to which the new value will be assigned, if the attribute stateTitle is present |
| setTo | The new value to assign to the TextReference identified in the set attribute or the text field / the field specified through setField / the index specified through setIndex of the title given through setTitle |
| selectedClass | An optional additional CSS class to be assigned if the popup is triggered or the tiddler specified in set already has the value specified in setTo |
| default | Default value if set tiddler is missing for testing against setTo to determine selectedClass |
| popup | Title of a state tiddler for a popup that is toggled when the button is clicked. See PopupMechanism for details |
| popupTitle | Title of a state tiddler for a popup that is toggled when the button is clicked. In difference to the popup attribute, no TextReference is used. See PopupMechanism for details |
| aria-label | Optional Accessibility label |
| tooltip | Optional tooltip |
| class | An optional CSS class name to be assigned to the HTML element |
| style | An optional CSS style attribute to be assigned to the HTML element |
| tag | An optional html tag to use instead of the default "button" |
| dragTiddler | An optional tiddler title making the button draggable and identifying the payload tiddler. See DraggableWidget for details |
| dragFilter | An optional filter making the button draggable and identifying the list of payload tiddlers. See DraggableWidget for details |
Note: In almost all other cases where a TextReference is used as a widget attribute, it will be placed between curly brackets, to transclude the value currently stored there. However, when we use a TextReference as the value of a button widget's set attribute, we are referencing the storage location itself, rather than the value stored there, so we do not use curly brackets there. Example: we could code a button widget that sets the caption field of TiddlerA to be the same as that of TiddlerB as:
<$button set="TiddlerA!!caption" setTo={{TiddlerB!!caption}} >
Press me!
</$button>Tip: Set class to tc-btn-invisible tc-tiddlylink to have a button look like an internal link.
El CamelCase se forma tomando una frase, poniendo la inicial de cada palabra en mayúscula y pegando una palabra a la otra, sin espacios. Esto hace que visualmente al texto le salgan jorobas y de ahí el nombre.
La mayoría de wikis usan CamelCase como una forma rápida de crear hipertexto.
CSS is a standard plain-text format used for defining the presentational style of the various elements on a web page.
| purpose | rounds a list of numbers up to the next largest integer |
|---|---|
| input | a selection of titles |
| output | rounds each of the input numbers up to the next largest integer |
New in: 5.1.20 See Mathematics Operators for an overview.
The changecount macro returns the number of times the current tiddler has been created, stored or deleted during the current TiddlyWiki session.
If a tiddler is deleted and subsequently recreated, its changecount will go up by two.
Parameters
(none)
<<changecount>>The value will increase if you edit this tiddler and store it again, even without making any changes to its content.
To access the changecount of a different tiddler, use a $tiddler widget:
<$tiddler tiddler="Draft of 'New Tiddler'">
<<changecount>>
</$tiddler>The value shown will increase whenever you create, store or delete New Tiddler.
Introduction
This release resolves a number of inconsistencies with the way that filters are handled. The changes mean that existing filters may need to be updated - particularly those that must deal with missing or shadow tiddlers.
Changes to is and addition of all
Most filter operators act by choosing some or all of their source titles to pass through or re-order. Those that add new entries that are not drawn from the source list are referred to as selectors. Prior to 5.0.9-beta, a few filter operators were inconsistent in whether they filtered from the source list or selected new entries into it.
The specific changes are:
- The is operator now always strictly filters from the currently selected list of tiddlers
- The new all operator acts as a selector by replacing the current list with a combination of tiddlers from specific sources:
- current for the current tiddler
- missing for all missing tiddlers
- orphans for all orphan tiddlers
- shadows for all shadow tiddlers
- tiddlers for all non-shadow tiddlers (including both system and non-system tiddlers)
The sources for the all operator can be combined with the + character. For example, [all[shadows+tiddlers]] returns all shadow tiddlers and all ordinary tiddlers.
Previously, it was common to have [is[shadow]] at the start of a filter string to select all the shadow tiddlers. In 5.0.9 and above, this will not return all the shadow tiddlers, but instead just those ordinary tiddlers that are also shadow tiddlers (by virtue of having overridden one). The resolution is to use the new all operator. For example, consider this filter from 5.0.8:
[is[shadow]!has[draft.of]tag[$:/tags/AdvancedSearch]] [!is[shadow]!has[draft.of]tag[$:/tags/AdvancedSearch]] +[tag[$:/tags/AdvancedSearch]]In 5.0.9, that filter has been changed to:
[all[shadows+tiddlers]tag[$:/tags/AdvancedSearch]!has[draft.of]]Note how the all operator allows operations to be performed on tiddlers from combinations of sources.
Changes to [is[current]]
One result of the changes is that [is[current]] now strictly filters from the source tiddlers; so, if the current tiddler is a missing tiddler not in the source list, then [is[current]] will return an empty list.
The solution is generally to use [all[current]] instead. It doesn't read as well, but has the required behaviour of returning just the current tiddler, regardless of whether it is in the source tiddlers.
Changes to title and field
There are minor changes to the way that the title and field operators work.
The title operator is a selector: it returns the specified title regardless of whether it is in the current source. title is used as the default operator if none is specified
The field operator is a filter: it only returns a subset of the source tiddlers. field is used as the default operator if the supplied operator is not defined (the supplied operator is passed as the suffix to the field operator, so [description[Missing]] is equivalent to [field:description[Missing]]).
Introduction
The checkbox widget displays an HTML <input type="checkbox"> element that is dynamically bound to either:
- the presence or absence of a specified tag on a specified tiddler
- the value of a specified field of a specified tiddler
Content and Attributes
The content of the <$checkbox> widget is displayed within an HTML <label> element immediately after the checkbox itself. This means that clicking on the content will toggle the checkbox.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler to manipulate (defaults to the current tiddler) |
| tag | The name of the tag to which the checkbox is bound |
| invertTag | When set to yes, flips the tag binding logic so that the absence of the tag causes the checkbox to be checked |
| field | The name of the field to which the checkbox is bound |
| index | New in: 5.1.14 The index of the tiddler, a DataTiddler, to which the checkbox is bound |
| checked | The value of the field corresponding to the checkbox being checked |
| unchecked | The value of the field corresponding to the checkbox being unchecked |
| default | The default value to use if the field is not defined |
| class | The class that will be assigned to the label element |
| actions | New in: 5.1.14 A string containing ActionWidgets to be triggered when the status of the checkbox changes (whether it is checked or unchecked) |
| uncheckactions | New in: 5.1.16 A string containing ActionWidgets to be triggered when the checkbox is unchecked |
| checkactions | New in: 5.1.20 A string containing ActionWidgets to be triggered when the checkbox is checked |
Tag Mode
Using the checkbox widget in tag mode requires the tag attribute to specify the name of the tag. The tiddler attribute specifies the tiddler to target, defaulting to the current tiddler if not present.
This example creates a checkbox that flips the done tag on the current tiddler:
<$checkbox tag="done"> Is it done?</$checkbox>Este es su aspecto:
Field Mode
Using the checkbox widget in field mode requires the field attribute to specify the name of the field. The checked and unchecked attributes specify the values to be assigned to the field to correspond to its checked and unchecked states respectively. The default attribute is used as a fallback value if the field is not defined.
This example creates a checkbox that is checked if the field status is equal to open and unchecked if the field is equal to closed. If the field is undefined then it defaults to closed, meaning that the checkbox will be unchecked if the status field is missing.
<$checkbox field="status" checked="open" unchecked="closed" default="closed"> Is it open?</$checkbox><br>''status:'' {{!!status}}Este es su aspecto:
status:
Index Mode
To use the checkbox widget in index mode set the index attribute to the index of a DataTiddler. The checked and unchecked attributes specify the values to be assigned to the index and correspond to its checked and unchecked states respectively. The default attribute is used as a fallback value if the index is undefined.
The example below creates a checkbox that is checked if the index by the name of this tiddler in the tiddler ExampleData is equal to selected and unchecked if the index is an empty string. If the index is undefined then it defaults to an empty string, meaning the checkbox will be unchecked if the index is missing.
<$checkbox tiddler="ExampleData" index=<<currentTiddler>> checked="selected" unchecked="" default=""> Selected?</$checkbox>Este es su aspecto:
You can use triple backticks ``` to mark code blocks ():
``` This will be monospaced ```
Renders as:
This will be monospacedTo be interpreted correctly, the three backticks need to be at the start of the line and immediately followed by a line-break.
Be aware that any preceding paragraph content should be properly terminated with a double line break, too. So, this example is wrong:
This is an ordinary paragraph ``` This will be monospaced ```
The correct version is:
This is an ordinary paragraph ``` This will be monospaced ```
Note that some keyboard layouts treat the backtick as a dead key, making it hard to type. The trick is to type three backticks followed by a space. Alternatively, type all six backticks in one go, then a space, and then move the cursor back three characters to type or paste the content.
Introduction
The codeblock widget renders text in <pre> and <code> blocks, causing it to be
displayed monospace. A language may optionally be specified using the
language attribute, however syntax highlighting will only be used if the
Highlight Plugin is installed.
Content and Attributes
The content of the <$codeblock> widget is ignored.
| Attribute | Description |
|---|---|
| code | Contents of the block to render as code |
| language | Programming language for syntax highlighting |
The language attribute accepts either:
- a Highlight.js language code (see https://highlightjs.org/static/demo/ for a list)
- a MIME type (eg,
text/htmlorimage/svg+xml)
Examples
Here is an example embedding the contents of a tiddler as a code block.
<$codeblock code={{$:/editions/tw5.com/macro-examples/say-hi}} />Este es su aspecto:
\define sayhi(name:"Bugs Bunny" address:"Rabbit Hole Hill")
Hi, I'm $name$ and I live in $address$.
\end
A codeblock may also specify a language.
<$codeblock code="SELECT * FROM users WHERE deleted = false" language="sql" />Este es su aspecto:
SELECT * FROM users WHERE deleted = falseEl plugin CodeMirror incorpora un sofisticado editor web de texto.
DIsponible en: https://tiddlywiki.com/plugins/tiddlywiki/codemirror/
The colour (or color) macro returns the CSS value of one the colours in the current palette.
If no such entry exists in the current palette, the vanilla palette is used instead.
Parameters
- name
- The name of the palette entry, e.g.
page-background
<<colour code-border>><<colour foreground>><<colour page-background>><<colour sidebar-tab-background>><<colour tag-foreground>>Colour: <$edit-text tiddler='$:/_MyColour' tag='input' placeholder='(unset)' default=''/>
---
<$macrocall $name='colour-picker' actions="
<$action-setfield $tiddler='$:/_MyColour' $value=<<colour-picker-value>>/>
"/>Una paleta de colores es un tiddler de datos que proporciona valores CSS a una serie de parámetros de color de diferentes componentes, definidos de esta manera:
page-background: #fe0
table-border: #ccc
...Hay varias paletas definidas en el núcleo de TiddlyWiki. El tiddler $:/palette contiene el título de la paleta actualmente seleccionada.
Para saber el color de algún elemento definido en la paleta actual, por ejemplo para su uso en una hoja de estilos, se puede usar la macro color:
<<colour page-background>>Devuelve el siguiente valor, correspondiente al color aplicado al componente "page-background": #f4f4f4.
Los tiddlers que definen una paleta de color tienen que tener los siguientes campos:
| Nombre | Valor |
|---|---|
| title | Lleva el prefijo $:/ |
| type | application/x-tiddler-dictionary |
| tags | $:/tags/Palette |
| description | Descripción para mostrar en el selector de paletas |
| text | nombre: valor |
El valor CSS puede definirse bien usando un nombre predefinido (p.ej: BlanchedAlmond), su valor hexadecimal (p.ej, para el anterior: #FFEBCD), o rgba (el anterior: 255, 235, 205,1)
CSV is a standard plain-text format for storing a table of data.
Each row of the table is called a record and occupies one line.
The columns are called fields. Each field of a row is separated from the next by a comma, and is often delimited by quotation marks.
The csvtiddlers macro returns tiddler content in this format.
Un comando es una de las siguientes palabras, escritas con el prefijo --, usada como opción en la línea de comandos para indicar a TiddlyWiki en Node.js qué acción se desea.
| purpose | select the titles of all the Node.js commands |
|---|---|
| input | ignored |
| parameter | none |
| output | the command words that can be given to TiddlyWiki on Node.js |
Aquí reunimos las últimas y más útiles novedades procedentes de la comunidad TiddlyWiki.
Las últimas noticias, artículos, recursos y ejemplos.
"Font Awesome 5 Free SVGs for TiddlyWiki" by morosanuae
The Font Awesome 5 Free SVG images collection converted to tiddlers that you can easily import (drag'n'drop) in your wiki.
TiddlyDrive Add-on for Google Drive by Joshua Stubbs
An add-on for Google Drive that allows TiddlyWiki files stored there to be opened and saved directly
To find out how to add it to your account, go to the project's info page: https://lordratte.gitlab.io/tiddlydrive/#installation-guide
I made an app that lets one edit TiddlyWiki files saved in your Google drive and then saving them back automagically. The page is here https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo but I think you need to add it from the Google Drive web interface.
I even added an optional ability to save with ctrl + s hotkeys.
Joshua's launch post
Json Mangler plugin by Joshua Fontany
Extend tiddlywiki to parse complex ("nested") json data tiddlers.
Json Mangler introduces a new path syntax for indexes of json data tiddlers , and includes many supporting tools, filters, widgets, etc.
Example Wiki: https://joshuafontany.github.io/TW5-JsonManglerPlugin/
Source: https://github.com/joshuafontany/TW5-JsonManglerPlugin
Disqus comments plugin by bimlas
Use this plugin to give your visitors the opportunity to comment on your tiddlers without changing the wiki itself.
Disqus is a networked community platform used by hundreds of thousands of sites all over the web. With Disqus, your website gains a feature-rich comment system complete with social network integration, advanced administration and moderation options, and other extensive community functions.
Locator plugin by bimlas
For those who use many tags or store many different topics in a common wiki the Locator plugin is a table of contents widget and an enhanced search engine that gives you the opportunity to filter results by related tags. Unlike table of contents, standard search and list of tags, this plugin offers these features in an organic, collaborative way.
Kin filter operator by bimlas
The purpose of the kin operator with examples:
- Finds related tags, related tiddlers in any depth
- Finds out where base tiddler originates and what other elements originate from it
- Finds the ancestors and successors of a family member
- Finds the "leaves" of the branch of the base tiddler in a tree-like structure (where the base tiddler is a leaf)
- Finds the super- and subsets / groups of a mathematical set (where the base tiddler is a set)
"TiddlyWiki5^2 documenting while learning TiddlyWiki5" by Iannis Zannos
A wealth of hints, tips and notes about using TiddlyWiki on Node.js:
TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline.
The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web.
Also very cool is the treatment of tags as menus everywhere.
http://larigot.avarts.ionio.gr/users/iani/wikis/tw5square.html
Also available on GitHub (download and save index.html and open it in your browser).
Code styles and auto format settings for IDEs
Implementation of TiddlyWiki Coding Style Guidelines for different IDEs.
It's a frequent use case in TiddlyWiki that you will want to put the results of variables together with various bits of strings of text. This process in some programming languages is often referred to as "concatenating" text.
You might, for instance want to set up a template for your customer database, where links will automatically refer to additional contact information about your customer. Inside your tiddler, you might try something like this:
| ⚠ Warning: Don't do it this way! | [[Additional Info|<<currentTiddler>>-Contact]] |
But that won't work. If you try this, the link will be interpreted very literally, and will attempt to take you to:
<<currentTiddler>>-ContactThe solution is to use a macro to put the rendered value of <<currentTiddler>> together with the bit of additional text, -Contact.
Create a macro at the top of the tiddler like this:
\define linkup(link) [[Additional Info|$link$-Contact]]You might be tempted to invoke the new macro like this:
| ⚠ Warning: Don't do it this way! | <<linkup <<currentTiddler>> >> |
But if you do, you will find that <<currentTiddler>> doesn't get rendered, but instead gets passed literally.
Instead, you could use the MacroCallWidget widget, like this:
<$macrocall $name="linkup" link=<<currentTiddler>> />In this case, we passed the value of a variable directly to our macro. This is often a general way to go about this task. If you wanted to create more links based on other variables you could re-use the macro for each situation.
If, as in this case, the only variable you are using is currentTiddler then you could write a simple macro, like this:
\define linkup() [[Additional Info|$(currentTiddler)$-Contact]]Notice that in this case we don't pass an argument. Instead, we reference the variable using the special syntax $(variable)$. Since we don't pass an argument, we can invoke it without the <$macrocall> widget more simply, like this:
<<linkup>>
Estos son los conceptos básicos presentes en TiddlyWiki. Comprender cómo encajan estos conceptos unos con otros es fundamental para el conocimiento en profundidad de TiddlyWiki.
- Comandos Node.js
- Paletas cromáticas
- Current Tiddler
- Tiddlers de datos
- Campos de fecha
- DefaultTiddlers
- Tiddlers diccionario
- Imágenes externas
- Filtros
- Enlaces físicos y simbólicos
- JSONTiddlers
- Keyboard Shortcut Tiddler
- Macros
- Mensajes
- Modules
- Permalinks
- Pragma
- ShadowTiddlers
- Story River
- SystemTags
- SystemTiddlers
- TemplateTiddlers
- TextReference
- TiddlerFields
- Enlaces
- Tiddlers
- TiddlyWiki
- TiddlyWiki5
- Listas
- Selección de títulos
- Transclusion
- Wiki
- WikiText
- Etiquetas
- Plugins
- Variables
- Widgets
- Añadir a ~Tiddlywiki el Polyfill de Babel
New in: 5.1.20The conditional filter operators allow if-then-else logic to be expressed within filters.
The foundation is the convention that an empty list can be used to represent the boolean value false and a list with at one (or more) entries to represent true.
The conditional operators are:
- then Operator replaces any input values with a constant string. For example:
[[HelloThere]is[missing]then[FOO]]evaluates to (empty)[[Missing Tiddler]is[missing]then[FOO]]evaluates toFOO
- else Operator if the title list is empty then returns a constant string, otherwise returns the original title list
[[HelloThere]is[tiddler]else[BAR]]evaluates toHelloThere[[Missing Tiddler]is[tiddler]else[BAR]]evaluates toBAR
These operators can be combined. For example:
[[New Tiddler]is[missing]then[I am missing]else[No I am not missing]] evaluates to I am missing
The else Operator can be used to apply a defaults for missing values. In this example, we take advantage of the fact that the get Operator returns an empty list if the field or tiddler does not exist:
[[HelloThere]get[custom-field]else[default-value]] evaluates to default-value
You can configure TiddlyWiki to start up using whatever individual or group of tiddlers you want using the default tiddlers mechanism.
In the control panel under the info tab is an input field labeled "Choose which tiddlers are displayed at startup". You can list whatever tiddlers you want to open at startup. Use double square brackets for titles containing spaces. For example:
FirstTiddler
SecondTiddler
[[Third Tiddler]]You can also use filter expressions to open more than one tiddler. For example:
[tag[HelloThere]]will open all tiddlers tagged as .
You can also use this technique to preserve open tiddlers at startup
El tiddler de configuración $:/config/TiddlerInfo/Default contiene el título del tiddler de la pestaña abierta por defecto en el InfoPanel.
Su valor por defecto es $:/core/ui/TiddlerInfo/Tools, que corresponde a la pestaña Herramientas.
Todos los valores posibles para seleccionar la pestaña abierta por defecto son:
- $:/core/ui/TiddlerInfo/Tools
- $:/core/ui/TiddlerInfo/References
- $:/core/ui/TiddlerInfo/Tagging
- $:/core/ui/TiddlerInfo/List
- $:/core/ui/TiddlerInfo/Listed
- $:/core/ui/TiddlerInfo/Fields
- $:/core/ui/TiddlerInfo/Advanced
- $:/editions/tw5.com/TiddlerInfo/Sources
| purpose | filter the input by searching list fields for a value |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a field |
| parameter | S = a possible value to be found in list field F |
| output | those input tiddlers in which the list field F contains the value S |
! output | those input tiddlers in which the list field F does not contain the value S |
[[$:/StoryList]contains[HelloThere]]
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Used in Internet protocols to indicate the type that should be used to interpret the content of a web resource.
In TiddlyWiki, the type field gives the content type to apply to the main text field.
List of Common Content Types
| Group | Type | Content of type field |
|---|---|---|
| Developer | Data dictionary | application/x-tiddler-dictionary |
| JavaScript code | application/javascript | |
| JSON data | application/json | |
| Static stylesheet | text/css | |
| Image | GIF image | image/gif |
| ICO format icon file | image/x-icon | |
| JPEG image | image/jpeg | |
| PDF image | application/pdf | |
| PNG image | image/png | |
| Structured Vector Graphics image | image/svg+xml | |
| Text | HTML markup | text/html |
| CSS stylesheet | text/css | |
| Comma-separated values | text/csv | |
| Plain text | text/plain | |
| TiddlyWiki 5 | text/vnd.tiddlywiki | |
| TiddlyWiki Classic | text/x-tiddlywiki |
The contrastcolour macro returns whichever of two given CSS colours is deemed to contrast best with another.
An example can be seen in the template tiddler for tag pills.
Parameters
- target
- The colour to contrast against (typically a background colour)
- fallbackTarget
- An alternative colour to contrast against. This is used when
targetis undefined or not a valid colour - colourA
- The first of the two colours to choose between
- colourB
- The second of the two colours to choose between
Estamos encantados de recibir contribuciones al código y la documentación de TiddlyWiki, ya sea:
- Reportando Bugs
- Ayudando a mejorar la documentación
- Aportando código a través de GitHub
- Más detalles en https://tiddlywiki.com/dev
Hay, además, más formas de contribuir con el proyecto.
CLA: Acuerdo de licencia de contribución
Al igual que sucede en otros proyectos de Código Abierto, TiddlyWiki5 necesita que quien quiera contribuir con él, firme un acuerdo de licencia de contribución.
Es un acuerdo legal que permite a quien contribuye afirmar que los derechos de su contribución son exclusivamente suyos y que está de acuerdo en licenciarlos a la Asociación UnaMesa (entidad legal que, en nombre de la comunidad, es propietaria de TiddlyWiki).
- Si eres persona física, necesitas firmar la licencia individual
- Si eres persona fiscal, la de entidades
Cómo firmar el CLA
Crea un pull request en GitHub para añadir tu nombre a cla-individual.md o cla-entity.md, según corresponda si eres persona física o fiscal, con la fecha en formato YYYY/MM/DD.
paso a paso
- Según seas persona física o fiscal, ve a
- Haz clic en el botón Edit arriba a la derecha (al hacerlo se creará un fork del repositorio para que puedas editar el archivo)
- Añade tu nombre al final del documento
- P. Ej.:
Jeremy Ruston, @Jermolene, 2011/11/22
- P. Ej.:
- Bajo el cuadro de edición del documento, debieras ver otro más pequeño, con el título Propose file change
- Escribe un título que explique de qué cambio se trata (p. ej.: "signing the CLA")
- Haz clic en el botón verde que dice Propose file change
- En la página siguiente, haz clic en el botón verde que dice Create pull request
Los documentos que componen el CLA de este proyecto se crearon usando las siguientes plantillas del Proyecto Harmony:
- "HA-CLA-I-LIST Version 1.0" para el "CLA-individual"
- "HA-CLA-E-LIST Version 1.0" para el "CLA-entity"
Observaciones:
«When not owning the copyright in the entire work of authorship...»
En caso de que, como dice el texto, no seas propietario de los derechos de la totalidad del trabajo de tu autoría, exprésalo claramente. De otro modo, asumiremos que eres el único poseedor legal de los derechos de tu contribución al proyecto. En tal caso, proporciona también enlaces e información que aclare bajo qué licencia se distribuye el código del que no eres propietario.
Contributing to TiddlyWiki5
Estamos encantados de recibir contribuciones al código y la documentación de TiddlyWiki, ya sea:
- Reportando Bugs
- Ayudando a mejorar la documentación
- Aportando código a través de GitHub
- Más detalles en https://tiddlywiki.com/dev
Hay, además, más formas de contribuir con el proyecto.
CLA: Acuerdo de licencia de contribución
Al igual que sucede en otros proyectos de Código Abierto, TiddlyWiki5 necesita que quien quiera contribuir con él, firme un acuerdo de licencia de contribución.
Es un acuerdo legal que permite a quien contribuye afirmar que los derechos de su contribución son exclusivamente suyos y que está de acuerdo en licenciarlos a la Asociación UnaMesa (entidad legal que, en nombre de la comunidad, es propietaria de TiddlyWiki).
- Si eres persona física, necesitas firmar la licencia individual
- Si eres persona fiscal, la de entidades
Cómo firmar el CLA
Crea un pull request en GitHub para añadir tu nombre a cla-individual.md o cla-entity.md, según corresponda si eres persona física o fiscal, con la fecha en formato YYYY/MM/DD.
paso a paso
- Según seas persona física o fiscal, ve a
- Haz clic en el botón Edit arriba a la derecha (al hacerlo se creará un fork del repositorio para que puedas editar el archivo)
- Añade tu nombre al final del documento
- P. Ej.:
Jeremy Ruston, @Jermolene, 2011/11/22
- P. Ej.:
- Bajo el cuadro de edición del documento, debieras ver otro más pequeño, con el título Propose file change
- Escribe un título que explique de qué cambio se trata (p. ej.: "signing the CLA")
- Haz clic en el botón verde que dice Propose file change
- En la página siguiente, haz clic en el botón verde que dice Create pull request
Los documentos que componen el CLA de este proyecto se crearon usando las siguientes plantillas del Proyecto Harmony:
- "HA-CLA-I-LIST Version 1.0" para el "CLA-individual"
- "HA-CLA-E-LIST Version 1.0" para el "CLA-entity"
Observaciones:
«When not owning the copyright in the entire work of authorship...»
En caso de que, como dice el texto, no seas propietario de los derechos de la totalidad del trabajo de tu autoría, exprésalo claramente. De otro modo, asumiremos que eres el único poseedor legal de los derechos de tu contribución al proyecto. En tal caso, proporciona también enlaces e información que aclare bajo qué licencia se distribuye el código del que no eres propietario.
This file was automatically generated by TiddlyWiki5
Al igual que sucede en otros proyectos de Código Abierto, TiddlyWiki5 necesita que quien quiera contribuir con él, firme un acuerdo de licencia de contribución.
Es un acuerdo legal que permite a quien contribuye afirmar que los derechos de su contribución son exclusivamente suyos y que está de acuerdo en licenciarlos a la Asociación UnaMesa (entidad legal que, en nombre de la comunidad, es propietaria de TiddlyWiki).
- Si eres persona física, necesitas firmar la licencia individual
- Si eres persona fiscal, la de entidades
Las siguientes personas han dedicado generosamente su tiempo a contribuir al desarrollo de TiddlyWiki:
- Jeremy Ruston (@Jermolene)
- Dave Gifford (@giffmex)
- Bram Chen (@BramChen)
- Mario Pietsch (@pmario)
- Xavier Cazin (@xcazin)
- Eric Shulman (@ericshulman)
- Stephan Hradek (@Skeeve)
- BuggyJef (@buggyj)
- Nathan Cain (@natecain)
- Ton Gerner (@gernert)
- Devin Weaver (@sukima)
- João Bolila (@jbolila)
- David Johnston (@Brennall)
- David Jade (@davidjade)
- Bob Robison (@grayeul)
- @nameanyone
- Maurizio Pollio (@mpollio)
- Ogoshi Masayuki (@ogoshima)
- Chris Sugden (@csugden)
- @asampal
- Bow Yi Jang (@Eucaly)
- Mal Gamble (@malgam)
- Michael Fogleman (@mwfogleman)
- Daniel Barrett (@shendaras)
- Simon Baird (@simonbaird)
- James Anderson (@welford)
- Jon Lister (@jayfresh)
- @TheDiveO
- Danielo Rodríguez (@danielo515)
- @willover
- @slotik
- Irene Knapp (@IreneKnapp)
- Brian Shaver (@shakerlxxv)
- Tobi Beer (@tobibeer)
- Craig Cook (@BoyCook)
- Pau DeLuca(@PauDeLuca)
The copy-to-clipboard macro displays a button that copies specified text to the clipboard. A notification is displayed if the operation is successful; some browsers do not permit the operation.
Parameters
- src
- The text to be copied to the clipboard
- class
- Optional CSS classes to be assigned to the button (defaults to
tc-btn-invisible) - style
- Optional CSS styles to be assigned to the button
<<copy-to-clipboard "Mary had a little lamb">><$macrocall $name="copy-to-clipboard" src={{$:/SiteTitle}}/>Puedes copiar un tiddler individual de un TiddlyWiki a otro arrastrando su enlace de una ventana del navegador a otra.
The following macros are built into TiddlyWiki's core:
- changecount
- colour
- contrastcolour
- csvtiddlers
- datauri
- dumpvariables
- jsontiddlers
- lingo
- list-links
- makedatauri
- now
- qualify
- resolvepath
- Stylesheet Macros
- Table-of-Contents Macros
- tabs
- tag
- timeline
- unusedtitle
- version
- colour-picker
- copy-to-clipboard
- image-picker
- jsontiddler
- list-links-draggable
- list-tagged-draggable
- tag-picker
- tag-pill
- thumbnail
- tree
The following variables are built into TiddlyWiki's core:
- currentTiddler
- storyTiddler
- transclusion
- actionTiddler Variable
- modifier Variable
- namespace
- tv-history-list Variable
- tv-show-missing-links Variable
- tv-story-list Variable
- tv-tiddler-preview
The core will also use various configuration variables and macros if you define them:
| purpose | count the number of entries in a list |
|---|---|
| input | a selection of titles |
| output | a new list containing the number of items in the input list as a decimal string |
The number of the entries in the input list is counted and a decimal representation returned as a single string.
Introducción
CountWidget muestra el número de tiddlers que coinciden con determinada expresión de filtro.
Contenido y atributos
El contenido del widget <$count> se ignora.
| Atributo | Descripción |
|---|---|
| filter | Expresión de filtro para contar |
Para crear un formato personalizado de exportación de tiddlers en texto plano, sigue los siguientes pasos:
- Crea un tiddler con los siguientes campos y valores:
Tags:$:/tags/Exporterdescription: descripción del formatoextension: extensión de archivo por defecto, incluyendo el punto; por ejemplo,.tmx
- Escribe el siguiente contenido:
\define renderContent()
{{{ $(exportFilter)$ ||$:/core/templates/plain-text-tiddler}}}
\end
<<renderContent>>La variable exportFilter contiene un filtro que define qué tiddlers se exportarán.
By default, TiddlyWiki displays a blank screen while it is loading. You can add a special "splash screen" that is displayed while the wiki loads.
Larger TiddlyWiki files and those loaded over a slow network connection may take a little time to load. Once fully loaded, performance improves, because everything is now running entirely within the browser. Using a splash screen ensures people know the loading process is taking place, reducing the chance they will leave the page.
In order for the splash screen to be displayed before TiddlyWiki is initialised it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the SystemTag: $:/tags/RawMarkupWikified/TopBody.
In order to remove the splash screen when the wiki has finished loading, the HTML should be wrapped in a container with the special class tc-remove-when-wiki-loaded. Any DOM elements with this class are automatically deleted by the core once the wiki has loaded.
Here's an example of a simple splash screen that just displays the text Loading. To use it, copy the text into a new tiddler, give it the type "text/plain" and the tag "$:/tags/RawMarkupWikified/TopBody":
<div class="tc-remove-when-wiki-loaded">
Loading...
</div>If the tiddler is given the WikiText type text/vnd.tiddlywiki then the contents are wikified as the file is saved, allowing transclusion etc. For example, here's an example that quotes the site title in the loading message. To use it, copy the text into a new tiddler, give it the type "text/vnd.tiddlywiki" and the tag "$:/tags/RawMarkupWikified/TopBody":
\rules only filteredtranscludeinline transcludeinline
<div class="tc-remove-when-wiki-loaded">
Please wait while {{$:/SiteTitle}} is loading
</div>The \rules directive is used to limit the wikitext syntax that is recognised to the two forms of inline transclusion. This avoids accidental wikification of tiddler content.
There is a more complex example splash screen using CSS animations and images configured in this wiki: see $:/SplashScreen
Crear un tiddler
Un tiddler se crea con un simple clic, bien en el botón de la barra lateral, o en el enlace a un tiddler vacío, que se distinguen por estar en cursiva azul
Mira también:
Editar un tiddler
Haz clic en el botón , situado arriba a la derecha del tiddler que quieres editar.
Borrador
Cuando creas un tiddler nuevo o editas uno ya existente, el tiddler se muestra en modo borrador o de edición y muestra un panel de control que permite modificarlo de varias formas, compuesto de las siguientes partes (de arriba hacia abajo):
Campo de título - SIrve para cambiar el título de un tiddler (por defecto "Nuevo Tiddler")
- Selector de etiquetas - SIrve para añadir o quitar etiquetas. A medida que escribas en el cuadro, una lista desplegable te mostrará cualquier etiqueta ya existente que coincida con lo escrito. Puedes seleccionar una etiqueta de la lista o escribir una completamente nueva y pulsar el botón añadir para incorporarla al tiddler. Cada etiqueta se muestra como una píldora coloreada. Si haces clic en la x de una píldora, quitarás la etiqueta del tiddler y si no hay más tiddlers con esa etiqueta, la borrarás también de la lista.
- Área de texto - Escribe aquí el contenido del texto. Pulsando el botón mostrar vista previa verás qué aspecto tendrán tus cambios cuando guardes el tiddler y salgas del modo de edición. Si te molesta, puedes ocultarla pulsando el botón ocultar vista previa.
- Selector de tipo - Se usa cuando hay que indicar a TIddlywiki que interprete ese tiddler de forma especial, de acuerdo con el tipo seleccionado. Por ejemplo, una imagen en jpg: si seleccionamos el tipo como "imagen .JPEG", Tiddlywiki sabrá cómo interpretar el tiddler y nos mostrará la imagen que queremos ver. Si no seleccionamos nada, nos mostrará un montón de código incomprensible, ya que el tipo por defecto es
text/vnd.tiddlywiki, lo que significa que el tiddler contiene WikiText... y como tal lo interpreta. - Selector de campos - Se usa para añadir o quitar campos del tiddler. Estos campos sirven tanto para complementar la información del tiddler como para establecer la relación que mantiene con otros. Por ejemplo: si estás editando un tiddler que servirá para etiquetar a otros tiddlers, puedes añadir un campo ''list'' para establecer el orden que esos otros tiddlers tendrán en la lista.
Guardar, cancelar o borrar
Cuando termines con la edición, pulsa uno de los botones que tienes arriba a la derecha del tiddler:
- El botón guarda los cambios realizados en el tiddler y sale del editor.
- Si tienes el wiki configurado para que guarde automáticamente los cambios, no necesitas hacer nada más: tus cambios quedan guardados de forma permanente al salir del editor. Si no tienes el Autosave configurado, los cambios se guardan sólo temporalmente en el navegador y se perderán en cuanto cierres la página. TiddlyWIki te avisa en tal caso de que tienes cambios pendientes de guardar mostrándote un botón rojo a la derecha, en la barra lateral.
- Ese es el botón . Para conservar tus cambios permanentemente, haz clic en él. TiddlyWiki guardará los cambios y el botón cambiará su color, indicando que ya no hay peligro.
- El botón interrumpe la edición, descarta todos los cambios (previa confirmación) y sale del editor.
- El botón elimina por completo el tiddler. Para hacerlo pide confirmación, pero ten en cuenta que una vez confirmado, el borrado de un tiddler es irrecuperable.
Introducción
Las entradas de diario son tiddlers que usan fechas u horas como título. Son una forma rápida de registrar información que precisa de algún tipo de marca de tiempo.
En ellos puedes, como en cualquier otro tiddler, usar etiquetas para enlazar con otros y así establecer diferentes relaciones entre fragmentos de información que de otro modo estarían inconexos.
Por ejemplo: podemos usar una entrada de diario titulada 10 de octubre para registrar pensamientos e información diversa de aquel día. Las etiquetas shopping y Londres podrían servirnos, además de para indicarnos que esa fecha tiene que ver con estar de shopping en Londres, para etiquetar con ellas cualquier otra información relativa a ambos temas.
Creación de una entrada de diario
La manera más sencilla es mediante el botón de la pestaña Herramientas de la barra lateral. Si lo usas con frecuencia, pincha en la casilla para que aparezca entre los iconos que se muestran sobre el cuadro de búsqueda.
El botón crea un tiddler en blanco con etiqueta Diario y título derivado de la fecha de hoy. Si ya existe una entrada con esa misma fecha, entonces lo abre para su edición.
Creación de una entrada con etiquetas
Es habitual, revisando u organizando notas o trabajando en grupo, crear una entrada con la fecha del día y etiquetarla con el título de los tiddlers que revisamos. Además de creando una entrada y escribiendo etiquetas manualmente, tenemos otra forma de hacerlo, que añade automáticamente las etiquetas:
- En el tiddler que estamos revisando, pinchamos en el botón y hacemos clic en .
- Algo menos a mano, peo igualmente útil, este botón está también está en la pestaña Herramientas del panel de del tiddler.
- En el siguiente tiddler que revisemos, repetimos la operación anterior y se nos volverá a abrir la entrada, que además de la etiqueta
Diarioy la del título anterior, llevará ya la del nuevo.
Pongamos por caso que estamos revisando un tiddler llamado Quijote. Del modo antes descrito, tendremos una entrada con la fecha del día y la etiqueta Quijote en la que hacer nuestras anotaciones, que guardamos y cerramos para seguir revisando notas.
Al rato, mientras revisamos otro tiddler llamado Hamlet, repetimos la operación y el resultado será la entrada del día abierta y lista para escribir en ella nuestra anotación, con las etiquetas Diario, Quijote y Hamlet añadidas automáticamente, sin riesgo de equivocarnos y sin tener que perder concentración rebuscando entre otras entradas.
Customización de entradas
Podemos configurar mínimamente cómo se crean las nuevas entradas de diario en la pestaña Básico, de la sección Información del panel de control
- Formato de título para las nuevas entradas de diario permite especificar el título de las entradas como una cadena con formato de fecha. El valor por defecto
DD de MMM de YYYYda como resultado fechas del estilo "10 de octubre de 2014" - Etiqueta para las nuevas entradas de diario permite especificar qué etiquetas aparecerán por defecto al crear nuevas entradas. Por ejemplo:
DIario [[Vacaciones de verano]]...etc
Nota: Si quieres crear entradas separadas cada vez que pulses , aunque lo hagas varias veces el mismo día, puedes incluir la hora en el formato del título. Algo como YYYY-0MM-0DD a las 0hh0mm'0ss'' dará como resultado títulos del estilo 2016-06-08 a las 07:09:05
Nota2: Otro truco muy útil es incluir $(currentTiddler)$ en el título. Esto significa que si pulsas en un tiddler, su título, además de etiquetar la entrada, forma parte del título.
Este ejemplo muestra cómo, dentro de un un tiddler, se pueden mostrar subhistorias independientes de la historia principal.
Este es el código:
<$navigator story="MiSubHistoria" history="MiSubHistoria">
Haz clic en este enlace para empezar:[[¡Hola! ¿Qué tal?|HelloThere]]
<$list filter="[list[MiSubHistoria]]" history="MiSubHistoria">
<div>
! <$button message="tm-close-tiddler" class="tc-btn-invisible">{{$:/core/images/close-button}}</$button> <$view field="es-title"/>
<$transclude/>
</div>
</$list>
</$navigator>Ahora puedes abrir el tiddler ¡Hola! ¿Qué tal? como subhistoria haciendo clic en el siguiente enlace. Los enlaces de la subhistoria se abren en la subhistoria y no en la principal.
Haz clic en este enlace para empezar:¡Hola! ¿Qué tal?
¡Hola! ¿Qué tal?
¿Nunca has tenido la sensación de que no te cabe en la cabeza todo lo que tienes que recordar?
BIenvenido a TiddlyWiki, un bloc de notas no lineal único para capturar, organizar y compartir información compleja.
Úsalo para mantener tu lista de tareas, para desarrollar un ensayo o novela, o incluso para organizar tu boda. Toma nota de todo cuanto te pase por la cabeza o construye una web flexible y ágil, que satisfaga tus necesidades.
Al revés que los servicios online convencionales, TiddlyWiki te deja escoger dónde quieres guardar tus datos, garantizándote que, por más que pase el tiempo, podrás seguir usando en el futuro las notas que tomes hoy.
The csvtiddlers macro returns the fields of a selection of tiddlers in CSV form, with one record (row) per tiddler.
An example can be seen in the template tiddler for CSV exports.
Parameters
- filter
- A filter selecting which tiddlers to include
- format
- Reserved for future extension. Should be set to
quoted-comma-sep
La variable current tiddler proporciona el contexto en el que se interpretan diversos aspectos de WikiText.
Por ejemplo, {{!!title}} indica el valor del campo title de cualquier tiddler actual, sea este cual sea. Esta técnica puede usarse para crear plantillas de uso general.
El título del tiddler actual siempre se puede invocar con la variable currentTiddler.
Las dos formas principales en que se puede cambiar el tiddler actual son:
Por lo tanto, decir "el tiddler actual" no siempre equivale a decir tiddler que se está viendo o editando.
The currentTiddler variable contains the title of the current tiddler.
Several aspects of WikiText use this tiddler as their context. As a result, within a $list widget or a template tiddler, there is often no need to explicitly specify a tiddler title.
Compare storyTiddler.
The following two examples have the same meaning:
<$view field=title/><$view tiddler=<<currentTiddler>> field=title/>This next example shows how the $list widget changes the current tiddler:
<ol>
<$list filter="[prefix[J]]">
<li><<currentTiddler>></li>
</$list>
</ol>Attribute: data-tags
New in: 5.1.16
The TiddlyWiki core adds several attributes to the rendered content. These make it possible to apply custom styles to tiddlers.
For example this tiddler is tagged: and so the attribute looks like this:
data-tags="[[How to apply custom styles]] example-test"Important: Tiddler tags are not sorted so the order in the rendered output may be different!
Examples
The following CSS is defined in Custom data-styles and creates a pink border for all tiddlers (including this one) tagged with example-test.
[data-tags*="example-test"] {
border: 2px solid pink;
}Styling Stylesheets
So to display tiddlers tagged: data-tags-styles in a decent way we can use the following code. (I could have used: $:/tags/Stylesheet, but that would affect all stylesheets in this wiki, which is not intended. amt ;)
Important: Don't forget to also specify .tc-tiddler-body or the whole tiddler, including the title, will be changed! see: Custom data-styles
[data-tags*="data-tags-styles"] .tc-tiddler-body {
display: block;
padding: 14px;
margin-top: 1em;
margin-bottom: 1em;
word-break: normal;
word-wrap: break-word;
white-space: pre-wrap;
background-color: #f5f5f5;
border: 1px solid #cccccc;
padding: 0 3px 2px;
border-radius: 3px;
font-family: Monaco, Consolas, "Lucida Console", "DejaVu Sans Mono", monospace;
}Hard Linebreaks
This mechanism may be handy for users who want to write prose text! See: Hard Linebreaks with CSS
More Possibilities
- [attr]
- Represents an element with an attribute name of attr.
- [attr="value"]
- Represents an element with an attribute name of attr and whose value is exactly "value".
- [attr~="value"]
- Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
- [attr|="value"]
- Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
- [attr^="value"]
- Represents an element with an attribute name of attr and whose first value is prefixed by "value".
- [attr$="value"]
- Represents an element with an attribute name of attr and whose last value is suffixed by "value".
- [attr*="value"]
- Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
- [attr "operator value" i]
- Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
Learn more at: Attribute selectors - CSS or CSS-Specification
Attribute: data-tiddler-title
New in: 5.1.16
The TiddlyWiki core adds several attributes to the rendered content. With those attributes it's possible to apply custom styles to the tiddler content.
For example this tiddler is named: "Custom styles by data-tiddler-title" so the attribute looks like this:
data-tiddler-title="Custom styles by data-tiddler-title"Examples
The following CSS is defined in Custom data-styles and creates a blue border for exactly this tiddler.
[data-tiddler-title="Custom styles by data-tiddler-title"] {
border: 1px solid blue;
}To create a green border for every tiddler that starts with $:/ aka system tiddlers, you'd need to use CSS like so: (not applied here but you can experiment with it! )
[data-tiddler-title^="$:/"] {
border: 1px solid green;
}More Possibilities
- [attr]
- Represents an element with an attribute name of attr.
- [attr="value"]
- Represents an element with an attribute name of attr and whose value is exactly "value".
- [attr~="value"]
- Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
- [attr|="value"]
- Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
- [attr^="value"]
- Represents an element with an attribute name of attr and whose first value is prefixed by "value".
- [attr$="value"]
- Represents an element with an attribute name of attr and whose last value is suffixed by "value".
- [attr*="value"]
- Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
- [attr "operator value" i]
- Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
Learn more at: Attribute selectors - CSS or CSS-Specification
Tiddler Field: class New in: 5.1.16
The tag manager allows us to set a tiddler color field, that is used to define the "tag-pill" colour. Since: New in: 5.1.16 we can define a class field, that is directly inserted into the ViewTemplate and it can be used for styling:
title: anyName
tags: $:/tags/Stylesheet
class: myClass
Every tiddler, that has a class field can be styled that way!
.myClass {
border: 2px solid blue;
}
Learn more at: How to apply custom styles
Información para customizar TiddlyWiki
- Configuring startup tiddlers
- Personalizar resultados de búsqueda
- Modificación del diseño de tiddlers y página
- Ajustes ocultos
- Adding a table of contents to the sidebar
- Pestaña por defecto de InfoPanel
- Formatos personalizados de exportación
- Creating a splash screen
- How to apply custom styles
- How to create keyboard shortcuts
- How to widen tiddlers (aka storyriver)
- Añadir pestañas a la barra lateral
- How to turn off camel case linking
- Making a custom journal button
- Tiddlers abiertos al inicio
- Favicons en TiddlyWiki
- Fondos de página
- Hojas de estilos
- Añadir pestaña de contenidos
Por defecto, los resultados de búsquedas en la barra lateral se muestran como una simple lista de títulos de tiddler. La forma de mostrar los resultados puede modificarse a gusto mediante plugins de visualización. Si el sistema detecta visualizaciones adicionales, las mostrará en pestañas.
Las distintas visualizaciones de resultados se guardan en tiddlers con la etiqueta $:/tags/SearchResults. La lista por defecto de resultados de búsqueda está implementada en el sistema y reside en el tiddler $:/core/ui/DefaultSearchResultList.
Para crear una nueva visualización de resultados:
- Crea un nuevo tiddler con la etiqueta
$:/tags/SearchResults - Usa la variable
searchTiddlerpara acceder al título del tiddler que contiene el término de búsqueda actual
Si quieres que sea la nueva visualización la que se muestre por defecto, crea un tiddler llamado $:/config/SearchResults/Default que contenga en el texto el título de la nueva visualización.
Este es un ejemplo de visualización alternativa que muestra los resultados en orden cronológicamente inverso:
\define searchResults()
<$set name="resultCount" value="""<$count filter="[!is[system]search{$(searchTiddler)$}]"/>""">
{{$:/language/Search/Matches}}
</$set>
<<timeline subfilter:"!is[system]search{$(searchTiddler)$}">>
\end
<<searchResults>>By default, a TiddlyWiki on Node.js instance using a wiki folder will create new tiddler files by using the sanitised and disambiguated title as filename.
This can be customised by creating a tiddler $:/config/FileSystemPaths containing one or more filter expressions, each on a line of its own. Newly created tiddlers are matched to each filter in turn, and the first output of the first filter to produce any output is taken as a logical path to be used for the tiddler file. Logical paths don't include the .tid extension, and they can use / or \ as directory separator (when generating the physical path, this is replaced by the correct separator for the platform TiddlyWiki is running on). If none of the filters matches, the logical path is simply the title with all occurences of / replaced by _ (for backwards compatibility).
In both cases, the characters <>:"\|?*^ are replaced by _ in order to guarantee that the resulting path is legal on all supported platforms.
Example
[is[system]removeprefix[$:/]addprefix[_system/]]
[tag[task]addprefix[mytasks/]]
[!has[draft.of]]This will store newly created system tiddlers in tiddlers/_system (after stripping the $:/ prefix), tiddlers tagged task in a subdirectory tiddlers/mytasks, and also create subdirectory structures for all other non-draft tiddlers.
Thus, $:/config/FileSystemPaths itself will end up in tiddlers/_system/config/FileSystemPaths.tid or tiddlers\_system\config\FileSystemPaths.tid, depending on the platform.
The final [!has[draft.of]] will match all remaining non-draft tiddlers. Because there was a match, any / or \ in the tiddler title is mapped to a path separator. Thus, some/thing/entirely/new will be saved to tiddlers/some/thing/entirely/new.tid (ie, the file new.tid in a directory called entirely).
El plugin D3 integra en TiddlyWiki la librería de visualización D3.
Disponible en: https://tiddlywiki.com/plugins/tiddlywiki/d3/
You can create an n-dash with a double hyphen -- and an m-dash with a triple hyphen ---. For example – this is an example — and so is this
A data URI is a way of storing data (such as an image) in a way that is compatible with the addresses used by web pages and stylesheets to access external resources.
The datauri macro can be used to generate data URIs within TiddlyWiki.
Un tiddler de datos o DataTiddler es una base de datos en miniatura, contenida en un tiddler.
Existen dos formatos estándar:
Se pueden definir otros formatos para obtener bloques de datos que se comporten como tiddlers de datos.
Para buscar un valor por su nombre, usa una Referencia textual. Por ejemplo, si un diccionario llamado DiasdelMes contiene:
oct:31
nov:30
dec:31... entonces, {{MonthDays##nov}} devolverá el valor 30.
Lo mismo sucede si DiasdelMes es un tiddler JSON con el siguiente contenido:
{"oct":31,"nov":30,"dec":31}The datauri macro returns a data URI for the content of a tiddler.
It is often used in stylesheet tiddlers to reference things like inline images and fonts:
background: url(<<datauri "Motovun Jack.jpg">>);
The data URI is automatically base64-encoded in the case of a non-text tiddler.
Parameters
- title
- The title of a tiddler, such as an image
<style>
.jack {
background: url(<$macrocall $name="datauri" title="Motovun Jack.jpg" $output="text/plain"/>);
height: 300px;
}
</style>
<div class="jack"/>The example has to invoke datauri through the $macrocall widget. It needs to prevent the macro's output from being parsed as WikiText, as that would transform the data URI into a $link widget and break the example. If the example was in a CSS tiddler, you could simply write:
background: url(<<datauri "Motovun Jack.jpg">>);
Algunos campos de tiddler se usan para guardar fechas y horas.
Los dos campos estándar son created y modified.
El valor de estos campos es una cadena de 17 caracteres:
- 4 dígitos para el año
- 2 dígitos para el mes
- 2 dígitos para el día
- 2 dígitos para la hora
- 2 dígitos para el minuto
- 2 dígitos para el segundo
- 3 dígitos para el milisegundo
Para evitar cualquier problema derivado de posibles diferencias horarias, TiddlyWiki siempre usa horas UTC.
Como ejemplo, el campo created de este tiddler tiene el valor 20150117190213631.
Las fechas pueden formatearse convenientemente para mostrarlas en pantalla:
<$view field="created" format="date" template="DDD DD de MMM de YYYY"/>Este es su aspecto:
sábado 17 de enero de 2015
ViewWidget acepta un atributo de plantilla que permite dar formato a los valores de fecha que se especifiquen. La cadena que da formato a la fecha se procesa con arreglo a las siguientes sustituciones:
| Símbolo | Valor sustitutivo |
|---|---|
DDD | Día completo de la semana |
ddd | Día de la semana, abreviado |
DD | Día del mes |
0DD | Día del mes, con cero delante |
DDth | Añade sufijo al día |
WW | Número de semana ISO-8601 |
0WW | Número de semana, con cero delante |
MMM | Mes completo |
mmm | Mes, abreviado |
MM | Mes, en cifras |
0MM | Mes, en cifras, con cero delante |
YYYY | Año completo |
YY | Año, en dos cifras |
wYYYY | Año completo con respecto al número de semana |
wYY | Año en dos cifras con respecto al número de semana |
hh | Hora |
0hh | Hora, con cero delante |
hh12 | Hora, en ciclos de 12 horas |
0hh12 | Hora en ciclos de 12 horas, con cero delante |
mm | Minutos |
0mm | Minutos, con cero delante |
ss | Segundos |
0ss | Segundos, con cero delante |
am o pm | Indicador am/pm en minúsculas |
AM o PM | Indicador AM/PM en mayúsculas |
TZD | Huso horario |
\ | Escape de caracteres. Los caracteres así marcados no se interpretan |
Otro texto añadido al formato pasa sin cambios, de modo que se admiten comas, guiones, barras, dos puntos y otros separadores.
Ejemplos
| Plantilla | Resultadao |
|---|---|
DDth de MMM de YYYY | 1º de mayo de 2011 |
DD MMM \M\M\M YYYY | 1 mayo MMM 2011 |
DD mmm hh:mm:ss | 1 may 2011 11:38:42 |
An interactive date picker plugin based on Pikaday. A demo can be found here: http://kixam.github.io/TW5-datePicker/.
datepicker is a TiddlyWiki plugin that allows you to use a widget much like EditTextWidget to pick a date, and optionaly a time. It shows a nice interactive mini-calendar when clicked, allows you to set a date format for display, and is compatible with core date fields such as
modifiedandcreated.
| purpose | filter the input by date |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a date field, defaulting to modified |
| parameter | D = a { positive | negative } number of days, defaulting to 0 |
| output | those input tiddlers in which field F is D days in the { future | past } or any time { before | after } that, including { past | future } |
! output | those input tiddlers in which field F is at least D days in the { future | past } |
Select tiddlers where a specified date field (default "modified") is within a specified date range. Time portion is ignored.
[days[-14]]
[!days:created[-800]]
The filter can be used to highlight new items in a list. For example:
<ul>
<$list filter="[tag[ReleaseNotes]!<currentTiddler>!sort[modified]]">
<li>
<$link><$view field="title"/></$link>
<$list filter="[<currentTiddler>days[-180]]"> @@color:red;^^new^^@@</$list>
<$list filter="[<currentTiddler>days[-500]!days[-180]]"> @@color:black;^^recent^^@@</$list>
</li>
</$list>
</ul>
Este es su aspecto:
- Release 5.1.21 new
- Release 5.1.20 new
- Release 5.1.19 recent
- Release 5.1.18 recent
- Release 5.1.17
- Release 5.1.16
- Release 5.1.15
- Release 5.1.14
- Release 5.1.13
- Release 5.1.12
- Release 5.1.11
- Release 5.1.10
- Release 5.1.9
- Release 5.1.8
- Release 5.1.3
- Release 5.1.5
- Release 5.1.6
- Release 5.1.7
- Release 5.1.4
- Release 5.1.2
- Release 5.1.1
- Release 5.1.0
| purpose | apply HTML decoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with HTML decoding applied |
"HTML decoding" means replacing HTML entities that represent special characters with that character:
&replaced with& replaced with<replaced with<>replaced with>"replaced with"
[[Title with < angle brackets >]] +[decodehtml[]]
[[Title with an & ampersand]] +[decodehtml[]]
| purpose | apply URI decoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with URI decoding applied |
[[Title%20with%20Space]] +[decodeuri[]]
[[Title%20with%20Space]] [[Another%20title%20with%20Space]] +[decodeuri[]]
| purpose | apply URI component decoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with URI component decoding applied |
See Mozilla Developer Network for details of the decodeURIComponent operation.
[[Title%20with%20Space]] +[decodeuricomponent[]]
[[Title%20with%20Space]] [[Another%20title%20with%20Space]] +[decodeuricomponent[]]
"Default tiddlers" refers to the list of tiddlers that is opened at startup in the browser if the address bar does not include a permalink).
At startup, the text of the system tiddler $:/DefaultTiddlers is retrieved and evaluated as a filter expression. The resulting list of titles is then inserted into the story river.
The control panel info/basics tab includes a text box for direct access to $:/DefaultTiddlers.
These are definitions of technical words and phrases used in this documentation. (As distinct from the Concepts that make up TiddlyWiki itself).
- Base64
- CamelCase
- Cascading Style Sheets
- Comma-Separated Values
- ContentType
- Data URI
- Document Object Model
- Federatial
- GitHub
- GuerillaWiki
- HyperText Markup Language
- JavaScript Object Notation
- JavaScript
- JeremyRuston
- Jermolene
- Keyboard Shortcut Descriptor
- MathML
- NW.js
- Node.js
- OpenSource
- Percent Encoding
- Quine
- Archivo único
- Página única
- Stanford JavaScript Crypto Library
- TiddlyDesktop
- TiddlyFox
- TiddlyIE
- TiddlySpace
- TiddlyWeb
- TiddlyWikiClassic
- URI
HTML definition lists are created with this syntax:
; Term being defined
: Definition of that term
; Another term
: Another definition
Tiene este aspecto:
- Term being defined
- Definition of that term
- Another term
- Another definition
... y su código HTML es:
<dl><dt>Term being defined</dt><dd>Definition of that term</dd><dt>Another term</dt><dd>Another definition</dd></dl>
New in: 5.1.20 Deletes a group of tiddlers identified by a filter.
--deletetiddlers <filter>First of all: Keep calm!
In several fields, deprecation is the discouragement of use of some feature, design or practice; typically because it has been superseded or is no longer considered safe – but without completely removing it or prohibiting its use.
wikipedia
For TiddlyWiki it means, that you should not use this mechanism for new content anymore! AND you should update your existing content!
Deprecated features have a marker. see: Custom styles by tag
Tiddlers tagged $:/deprecated
Die deutsche Übersetzung von TiddlyWiki ist verfügbar unter:
- Dokumentation: https://tiddlywiki.com/languages/de-DE/index.html
- Leer: https://tiddlywiki.com/languages/de-DE/empty.html
Siehe auch: Deutsch (Österreich) Edition.
Die österreichische Übersetzung von TiddlyWiki ist verfügbar unter:
- Dokumentation: https://tiddlywiki.com/languages/de-AT/index.html
- Leer: https://tiddlywiki.com/languages/de-AT/empty.html
Siehe auch: Deutsch (Deutschland) Edition.
There are several resources for developers to learn more about TiddlyWiki and to discuss and contribute to its development.
- tiddlywiki.com/dev is the official developer documentation
- TiddlyWikiDev group for discussions about TiddlyWiki development
- https://github.com/Jermolene/TiddlyWiki5 for the source code and development activity
Un tiddler diccionario es un tiddler de datos que contiene una simple lista de pares de nombre-valor.
Su tipo es application/x-tiddler-dictionary.
El campo text consta de una o más líneas con el formato name: value.
Una paleta de colores, es un ejemplo de diccionario.
Introduction
New in: 5.1.16 The diff text widget analyses the differences between a pair of source and destination text strings and displays the results as highlighted insertions and deletions (similar to the "track changes" function of a word processor). For example:
Hey Jude, don't make it bad. Take a sad song and make it better. Remember tobe afraid. You were made to go out and get her. The minute you let her intounder your heart↩︎
skin. Then you can startbegin to make it better.Content and Attributes
Content
The content of the <$diff-text> widget is rendered immediately before the diffs. Within it, the variable diff-count is available, containing the number of differences found. If the widget has no content then it automatically transcludes the tiddler $:/language/Diffs/CountMessage.
In other words, these three invocations are all equivalent:
<$diff-text source={{FirstTiddler}} dest={{SecondTiddler}}> {{$:/language/Diffs/CountMessage}} </$diff-text> <$diff-text source={{FirstTiddler}} dest={{SecondTiddler}}> </$diff-text> <$diff-text source={{FirstTiddler}} dest={{SecondTiddler}}/>
Attributes
| Attribute | Description |
|---|---|
| source | The source text |
| dest | The destination text |
| cleanup | See below |
The cleanup attribute determines which optional post-processing should be applied to the diffs:
- none: no cleanup is performed
- semantic (default): rewrites the diffs for human readability
- efficient: rewrites the diffs to minimise the number of operations for subsequent processing
(Note that in many cases the results will be the same regardless of the cleanup option. See the docs of the underlying library for more details).
Examples
In this example we compare two texts:
<$edit-text tiddler="SampleTiddlerFirst"/>
<$edit-text tiddler="SampleTiddlerSecond"/>
<$diff-text source={{SampleTiddlerFirst}} dest={{SampleTiddlerSecond}}/>Este es su aspecto:
This is a test tiddler is called SampleTiddlerFirstSecond.Disabling Plugins
Plugins can be disabled by creating a tiddler titled $:/config/Plugins/Disabled/ concatenated with the plugin title, and setting its text to yes.
For example, to disable the plugin $:/plugins/tiddlywiki/highlight, the title would be:
$:/config/Plugins/Disabled/$:/plugins/tiddlywiki/highlightNunca has visto nada parecido a esto. TiddlyWiki es:
- una herramienta,
- una caja de herramientas,
- una comunidad
- y toda una filosofía
TiddlyWiki es una herramienta
TiddlyWiki es, antes que nada, una herramienta libre y gratuita que se puede descargar para capturar y organizar contenidos: de la web, de tus documentos o directamente de tu cerebro. Es una herramienta para tomar notas, marcar y fijar referencias, escribir, administrar proyectos y tareas, colaborar en equipo, escribir un blog o publicar.
En TiddlyWiki creas o pegas contenidos en notas que llamamos tiddlers y las conectas entre sí con enlaces y etiquetas, de modo que puedas recuperarlas rápidamente mediante TagPills, pestañas y la ventana ultrarrápida de búsqueda de TIddlyWiki. También puedes incluir dinámicamente el contenido de un tiddler dentro de otro –como si jugaras con bloques de construcción– para crear artículos, listas, presentaciones y más.
TiddlyWiki es una caja de herramientas
Además de una herramienta versátil, TiddlyWiki es también una caja de herramientas
Donde otros productos para tomar notas te enganchan con un programa muy básico y luego te cobran por las características realmente útiles, TiddlyWiki cuenta con una creciente colección totalmente gratuita de temas visuales, paletas de color, plugins, widgets y macros que puedes combinar como prefieras para obtener un TiddlyWiki a medida y de la forma que tú y sólo tú quieres.
TiddlyWiki es también una comunidad online
Somos una comunidad de usuarios y desarrolladores que se ayuda mutuamente a imaginar nuevas formas de pensar, organizar y crear nuevas soluciones, de modo que TiddlyWiki evoluciona y se adapta contínuamente a tus necesidades. Los usuarios y desarrolladores de TiddlyWiki compartimos preguntas y consejos en el Grupo de Google de TiddlyWiki. También creamos tutoriales, adaptaciones y plugins para mejorar la experiencia de uso de TiddlyWiki. En la sección Comunidad del índice encontrarás más información al respecto.
Finalmente TiddlyWiki es una filosofía
El propósito de tomar notas y organizarlas es el poder recuperarlas más tarde para su uso. Si no hay forma de encontrar lo que buscas en el momento en que lo necesitas, tu programa de notas es, sencillamente, una monumental pérdida de tiempo.
Para la filosofía de TiddlyWiki, la mejor forma de tomar notas es fragmentando la información en sus unidades semánticas significativas más pequeñas. A estas unidades las llamamos tiddlers. Un tiddler puede ser una imagen, la dirección de una página, un concepto, la definición de un término o una adaptación especial, como, por ejemplo, una macro.
Estos tiddlers pueden luego entretejerse para crear con ellos unidades mayores de información: historias, artículos, listas, galerías de imágenes y mucho más. Las herramientas de TiddlyWiki como etiquetas, enlaces y filtros están especialmente diseñadas para relacionar y conectar tiddlers entre sí de múltiples maneras, facilitando así la futura recuperación de notas y permitiendo incluso descubrir relaciones inesperadas entre tiddlers y la información que contienen.
Use this plugin to give your visitors the opportunity to comment on your tiddlers without changing the wiki itself.
Disqus is a networked community platform used by hundreds of thousands of sites all over the web. With Disqus, your website gains a feature-rich comment system complete with social network integration, advanced administration and moderation options, and other extensive community functions.
| purpose | treating each input title as a number, divide them by the numeric value of the operand |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers, but with each one divided by N |
New in: 5.1.20 See Mathematics Operators for an overview.
The DOM of a web page is a tree-shaped model of its content, maintained internally by the web browser as the user interacts with that content. Each point in the tree is called a node.
When TiddlyWiki is running in a web browser, its widgets are rendered into DOM nodes for display.
When TiddlyWiki is running on Node.js, it uses a fake DOM to simulate the behaviour of a browser.
Las siguientes son macros utilizadas en la documentación de TiddlyWiki. Sus nombres comienzan con un punto para mantenerlas fuera del alcance accidental de nombres con los que el usuario pueda intentar experimentar.
Generales
| Macro | Se usa para | Ejemplo |
|---|---|---|
| .def | definición de un término | widget |
| .em | énfasis menor en una frase | cualquiera |
| .strong | énfasis mayor en un tiddler | ¡Importante! |
| .place | texto comodín | tagname |
| .word | mencionar una palabra o frase | "hello world" |
Advertencias
| Macro | Se usa para | Ejemplo |
|---|---|---|
| .tip | señalar consejos y recomendaciones | |
| .warning | señalar advertencias |
Bloques
| Macro | Se usa para |
|---|---|
| .preamble | enfatizar un preámbulo o un párrafo que sobresale del resto del texto |
Ejemplo:
- Esto es un ejemplo de bloque de preámbulo. Para que su visualización sea la correcta, debe constar de un único párrafo, separado del resto del texto por enters. No admite su inclusión en tablas ni la inclusión de macros, pero sí enlaces y formato en WikiText
Tiddlers y campos
| Macro | Se usa para | Ejemplo |
|---|---|---|
| .tid | referirse al título de un tiddler | Título de ejemplo |
| .tag | referirse a una etiqueta | Etiqueta de ejemplo |
| .field | referirse al campo de un tiddler | campo de ejemplo |
| .value | referirse al valor de un campo | valor de ejemplo |
| .op | referirse a un operador de filtro | backlinks |
| .var | referirse a una variable o nombre de macro | currentTiddler |
| .wid | referirse al nombre de un widget | $list |
| .attr | referirse al nombre de un atributo | filter |
| .param | referirse al nombre de un parámetro de macro | text |
Enlaces
| Macro | Se usa para | Ejemplo |
|---|---|---|
| .link | señalar enlaces con WikiText | esto es |
| .clink | señalar links con formato de código | <$list> |
| .dlink | señalar links internos con formato de definición | widget |
| .dlink-ex | señalar links externos con formato de definición | Ejemplo |
| .flink | señalar enlaces a campos | list |
| .mlink | señalar enlaces a macros | qualify |
| .mlink2 | señalar enlaces a macros, con targets específicos | foo |
| .olink | señalar enlaces a operadores de filtro | prefix |
| .olink2 | señalar enlaces a operadores de filtro con targets específicos | foo |
| .vlink | señalar enlaces a variables | currentTiddler |
| .vlink2 | señalar enlaces a variables, con targets específicos | foo |
| .wlink | señalar enlaces a widgets | $button |
| .wlink2 | señalar enlaces a widgets con texto específico | foo |
Interfaz de usuario
| Macro | Se usa para | Ejemplo |
|---|---|---|
| .key | indicar una tecla del teclado | Escape |
| .keycombo | indicar combinaciones de teclas | Ctrl+Enter |
Pestañas
| Macro | Se usa para | Ejemplo |
|---|---|---|
| .sidebar-tab | invocar el nombre de una pestaña de la barra lateral | Más |
| .more-tab | invocar el nombre de una subpestaña de la pestaña Más | Ocultos |
| .info-tab | invocar el nombre de una pestaña del InfoPanel | Campos |
| .controlpanel-tab | invocar el nombre de una pestaña del Panel de Control | Configuración |
| .advancedsearch-tab | invocar el nombre de una pestaña del cuadro de búsqueda avanzada | Filtro |
| .toc-tab | invocar el nombre del índice de tw5.com | Contenido |
| .example-tab | indicar un ejemplo de nombre de pestaña | Ejemplo |
Parámetros de .sidebar-tab
| Open | Abiertos |
| Recent | Recientes |
| Tools | Herramientas |
| More | Más |
Parámetros de .more-tab
| All | Todos |
| Recent | Recientes |
| Tags | Etiquetas |
| Missing | Vacíos |
| Drafts | Borradores |
| Orphans | Huérfanos |
| Types | Tipos |
| System | Sistema |
| Shadows | Ocultos |
Parámetros de .info-tab
| Tools | Herramientas |
| References | Referencias |
| Tagging | Etiquetado |
| List | Lista |
| Listed | En lista de |
| Fields | Campos |
| Advanced | Avanzado |
Parámetros de .controlpanel-tab
| Info | Información |
| Appearance | Aspecto |
| Settings | Configuración |
| Saving | Servidor |
| Plugins | Plugins |
Parámetros de .advancedsearch-tab
| Standard | Estándar |
| System | Sistema |
| Shadows | Ocultos |
| Filter | Filtro |
Botones
| Macro | Se usa para | Ejemplo |
|---|---|---|
| .button | insertar el nombre y el icono de un botón estándar |
Parámetros de .button
Barra de tiddler
| clone | |
| close | |
| close-others | |
| edit | |
| export-tiddler | |
| info | |
| more-tiddler-actions | |
| new-here | |
| new-journal-here | |
| permalink |
Barra de edición
| cancel | |
| delete | |
| save |
Barra de página
| advanced-search | |
| close-all | |
| control-panel | |
| encryption | |
| export-page | |
| full-screen | |
| home | |
| import | |
| language | |
| more-page-actions | |
| new-journal | |
| new-tiddler | |
| permaview | |
| refresh | |
| save-wiki | |
| storyview | |
| tag-manager | |
| theme |
La documentación de TiddlyWiki intenta seguir un estilo editorial consistente. Consta de dos áreas, cada una de ellas con su propio tono y dirigida a un público específico, así evitamos saturar de información al lector principiante mientras aún podemos ofrecer acceso rápido a la información que el lector experto necesita.
Temas adicionales:
Los filtros manipulan conjuntos de títulos en los que ningún título puede aparecer más de una vez. Muchas veces necesitan anexar unos conjuntos a otros.
En estos casos, la anexión se realiza de modo que si hubiera un título duplicado, se descarta el más antiguo y decimos que los títulos así anexados son dominantes.
Por ejemplo: si una selección contiene los títulos A, B, C, D y se anexa la selección compuesta por A, BB, C, DD, el resultado es B, D, A, C, BB, DD (En primer lugar, los títulos no duplicados de la primera selección, en segundo, la versión más nueva de los duplicados y en último, los no duplicados de la segunda selección).
Tiddlers that have a draft.of field are treated as pending drafts of the tiddler specified in the field. Draft tiddlers should also have a draft.title field that specifies the title that will be given to the tiddler when it is saved.
Several features work in concert to give the desired behaviour for draft tiddlers:
- The ListWidget can optionally render draft tiddlers through a different template
- The NavigatorWidget incorporates handlers for the following events:
tm-new-tiddlerfor creating a new tiddler in draft modetm-edit-tiddlerfor moving a tiddler into edit modetm-cancel-tiddlerfor cancelling a tiddler out of edit modetm-save-tiddlerfor saving a draft tiddler
- Draft tiddlers are automatically excluded from search operations
TiddlyWiki uses drag and drop to power two separate features:
- Importing Tiddlers into TiddlyWiki
- Manipulating tiddlers within a TiddlyWiki
Tiddler manipulation via drag and drop is supported by the core user interface in the following contexts:
- Entries in the "Open" tab of the sidebar can be reordered by drag and drop; new tiddlers can be opened by dragging their titles into the list
- Entries within a tag pill dropdown can be reordered by drag and drop; new tiddlers can be assigned the tag by dragging their titles into the list
- Entries in the control panel "Appearance"/"Toolbars" tab can be reordered by drag and drop. (Less usefully, new entries can be added to the toolbars by dragging their titles into the list)
All tiddler links are draggable by default. They can be dragged within a browser window for manipulating tiddlers, or dragged to a different browser window to initiate an import operation
If you want to drag a link, first move it vertically, because horizontal movement is recognized by the browser as text selection.
Tag pills are also draggable, and are equivalent to simultaneously dragging all of the individual tiddlers carrying the tag.
Some common scenarios for drag and drop tiddler manipulation are available as reusable macros:
- list-links-draggable Macro for reordering the entries in a tiddler ListField
- list-tagged-draggable Macro for reordering the tiddlers that carry a specified tag
See DragAndDropMechanism for details of how to use the low level drag and drop primitives to build more complex interactions.
The standard HTML 5 drag and drop APIs used by TiddlyWiki are not generally available on mobile browsers on smartphones or tablets. The Mobile Drag And Drop Shim Plugin adds an open source library that implements partial support on many mobile browsers, including iOS and Android.
This tiddler discusses the internal mechanisms that are used to implement drag and drop features in TiddlyWiki. See Drag and Drop for a general description of the features.
The following widgets are concerned with drag and drop features:
- The DraggableWidget creates a draggable element that represents one or more tiddlers for dragging
- The ButtonWidget and LinkWidget incorporate the functionality of the DraggableWidget
- The DroppableWidget creates an area into which tiddlers can be dragged to trigger customisable actions
- The DropzoneWidget handles importing external tiddlers from files or by drag and drop from another browser window
The general sequence of a drag and drop operation is as follows:
- The user clicks down and drags the pointer on a draggable element such as the DraggableWidget, ButtonWidget or LinkWidget
- The draggable element moves with the mouse pointer until the click is released
- Moving the pointer over droppable elements such as the DroppableWidget displays a highlight indicating that the item can be dropped
- The configured actions are performed if the drag ends on a droppable element
The DraggableWidget creates a DOM element that can be dragged by the user. It only works on browsers that support drag and drop, which typically means desktop browsers, but there are workarounds.
The draggable element can be assigned a list of tiddlers that are used as the payload. If desired it can invoke actions when dragging starts and when it ends. See DragAndDropMechanism for an overview.
Content and Attributes
| Attribute | Description |
|---|---|
| tiddler | Optional title of the payload tiddler for the drag |
| filter | Optional filter defining the payload tiddlers for the drag |
| class | Optional CSS classes to assign to the draggable element. The class tc-draggable is added automatically, and the class tc-dragging is applied while the element is being dragged |
| tag | Optional tag to override the default "div" element |
| startactions | Optional action string that gets invoked when dragging starts |
| endactions | Optional action string that gets invoked when dragging ends |
Either or both of the tiddler and filter attributes must be specified in order for there to be a payload to drag.
The actionTiddler Variable is accessible in both startactions and endactions. It holds the payload tiddler(s) specified through the tiddler and filter attributes as a Title List using double square brackets to quote titles that include whitespace.
The LinkWidget incorporates the functionality of the DraggableWidget via the draggable attribute.
The droppable widget creates a DOM element onto which dragged items can be dropped by the user, triggering the specified actions. It only works on browsers that support drag and drop, which typically means desktop browsers, but there are workarounds.
See DragAndDropMechanism for an overview.
Content and Attributes
| Attribute | Description |
|---|---|
| actions | Actions to be performed when items are dropped |
| class | Optional CSS classes to assign to the draggable element. The class tc-droppable is added automatically, and the class tc-dragover is applied while an item is being dragged over the droppable element |
| tag | Optional tag to override the default of a "div" element when the widget is rendered in block mode, or a "span" element when it is rendered in inline mode |
Within the action string, there are two Variables generated by the DroppableWidget:
- The actionTiddler Variable contains the title of the item being dropped
- The modifier Variable contains the Modifier Key held while dragging (can be normal, ctrl, shift or ctrl-shift)
If multiple items are dropped then the actions are performed repeatedly, once for each dropped item.
Examples
This example displays a palette of icons. Dragging a tiddler onto one of the icons assigns that icon to the tiddler.
Similarly, this example shows a palette of colours. Dragging a tiddler onto one of the colours assigns that colour to be used for rendering the icon of the tiddler.
Introduction
The dropzone widget creates an area into which the user can drag files and other objects. It also supports pasting via the clipboard, although browser support is currently limited.
It sends a WidgetMessage: tm-import-tiddlers carrying a JSON representation of the tiddlers to be imported up through its parents. This message usually trapped by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.
Content and Attributes
| Attribute | Description |
|---|---|
| deserializer | New in: 5.1.15 Optional name of deserializer to be used (by default the deserializer is derived from the file extension) |
The list of available deserializers can be inspected by executing Object.keys($tw.Wiki.tiddlerDeserializerModules).sort().join("\n") in the browser JavaScript console.
The dropzone widget displays any contained content within the dropzone.
Display
The dropzone widget creates an HTML <div class="tc-dropzone"> to contain its content. During a drag operation the class tc-dragover is added. CSS is used to provide user feedback.
Data types supported
The following data transfer types are supported:
- text/vnd.tiddler - a list of tiddlers in JSON format (this format is generated by the LinkWidget)
- text/plain - plain text
- text/uri-list - a list of URIs as a single tiddler
The dumpvariables macro returns a table showing the values of all variables and macros that exist at that position in the widget tree.
It is useful for debugging and exploring TiddlyWiki's internals.
Placeholders are replaced with values in the normal way, but using the default values for all macro parameters.
Parameters
(none)
<$set name="EXAMPLE" value="123..789">
<$set name="EXAMPLE2" value="456">
<<dumpvariables>>
</$set>
</$set>The Dynaview Plugin makes it possible to build user interfaces that dynamically respond to changes in the browser viewport via scrolling or zooming:
- CSS classes that allow rendering to be deferred until the output is scrolled into view
- CSS classes that allow the opacity of DOM elements to vary according to the current zoom level
See the demo at https://tiddlywiki.com/plugins/tiddlywiki/dynaview
| purpose | select one of each group of input titles by field |
|---|---|
| input | a selection of titles |
| suffix | optionally, list-item or value |
| parameter | F = the name of a field, defaulting to title |
| output | a selection containing the first input title encountered for each distinct value of field F |
Each input title is processed in turn. The value of field F in the corresponding tiddler is examined.
- each
- As long as the value of the field is unique (i.e. has not been encountered before), the title is appended to the output.
- each:list-item
- The value is treated as a title list. Each title in the list considered in turn. If it has not been encountered before, it is appended to the output.
- each:value
- As long as the title is unique it is appended to the output whether or not the corresponding tiddler exists.
If a tiddler does not contain field F, it is treated as if the value of the field were empty.
[each[color]]
[sort[title]each[type]]
[each:list-item[list]]
[[Non existing]] [[GettingStarted]] +[each:value[]]
+[each[]] below[[Non existing]] [[GettingStarted]] +[each[]]
+[each:value[]] aboveFor an example of using the each operator to generate a two-tier list of groups and members, see GroupedLists.
| purpose | select one of each group of input titles by date |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a date field, defaulting to modified |
| output | a selection containing the first input title encountered for each distinct value (ignoring times of day) of field F |
Each input title is processed in turn. The value of field F in the corresponding tiddler is examined, and as long as this indicates a date that has not been encountered before, the title is appended to the output.
If a tiddler doesn't contain field F, it contributes nothing to the output.
[eachday[created]]
For an example of using the eachday operator to generate a two-tier list of groups and members, see GroupedLists.
La edición española de TiddlyWiki se encuentra aquí:
- Documentación : https://tiddlywiki.com/languages/es-ES/index.html
- TiddlyWiki en blanco : https://tiddlywiki.com/languages/es-ES/empty.html
Introduction
The edit bitmap widget provides a user interface in the browser for editing bitmap tiddlers.
Content and Attributes
The content of the <$edit-bitmap> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | The tiddler to edit (defaults to the current tiddler) |
Configuration
The edit bitmap widget can be configured with these system tiddlers:
- $:/config/BitmapEditor/LineWidth determines the line width:
- $:/config/BitmapEditor/Colour determines the line color:
Michael Fogleman ha escrito tid-mode, un modo de edición para Emacs con el fin de editar los archivos .tid de TiddlyWiki. Deriva de text-mode, se vale de los útiles minor modes org-struct y subword y actualiza los tiempos de modificación al guardar un archivo .tid.
Redactó también dos funiones de ayuda para editar TiddlyWiki con Emacs. El primero abre un directorio de tiddlers en Dired. El segundo abre TiddlyWiki en el navegador.
(defun open-wiki ()
"Abre un directorio de TiddlyWiki en Dired."
(interactive)
(dired "~/Dropbox/wiki/tiddlers/"))(defun browse-wiki ()
"Abre TiddlyWiki en el navegador."
(interactive)
(browse-url "127.0.0.1:8080/"))Esta última función puede requerir que se indique un navegador:
(setq browse-url-browser-function 'browse-url-generic
browse-url-generic-program "chromium")Puedes vincular cualquiera de estas funciones con la función global-set-key:
(global-set-key (kbd "C-c w") 'open-wiki)Por el momento, no están integradas en tid-mode.
Devin Weaver ha escrito un plugin para Vim, publicado en https://github.com/sukima/vim-tiddlywiki
Soporta la mayor parte de la sintaxis de TiddlyWiki e incluye un plugin que actualiza automáticamente el campo modified.
| purpose | select the descriptions of the input editions |
|---|---|
| input | a selection of edition names |
| parameter | none |
| output | the description string of each edition in the input |
Each input title is processed in turn, ignoring any that is not the name of a TiddlyWiki edition.
- Note
- This operator is not available when TiddlyWiki is running in a web browser.
TiddlyWiki se distribuye en distintas ediciones, especialmente concebidas para servir a un propósito determinado.
Una edición consta de los componentes del núcleo de TiddlyWiki, así como plugins, documentación y ejemplos de contenido para que puedas ponerte en marcha lo antes posible.
Los componentes de las diferentes ediciones pueden combinarse y modificarse de modo que construyas la mejor solución para tu aplicación particular.
| purpose | select the names of all the TiddlyWiki editions |
|---|---|
| input | ignored |
| parameter | none |
| output | the name of each TiddlyWiki edition, in alphabetical order |
- Note
- This operator is not available when TiddlyWiki is running in a web browser.
Lista y descripción de las ediciones disponibles.
Puedes crear una edición específica con el comando --init.
--editionsHow it Works
The editor toolbar is a toolbar that helps you format text easily. It appears above the text input field in a tiddler when in edit mode. It has a similar appearance to desktop text editors like Microsoft Word or Libre Office Write.
What the Editor toolbar does
When you press the button for a function, it will insert the WikiText in the text field. As an example, if you press the bold button it will insert '' ''.
If you highlight a piece of text the markup code will automatically go around the highlighted text.
If you are in another mode, like MarkDown, the toolbar will change to that syntax and insert appropriate code. However It will not change previously typed text or markup.
Besides the standard WikiText formatting, the Editor toolbar has the following buttons:
Introduction
The edit text widget provides a user interface in the browser for editing text tiddler fields. The editing element is dynamically bound to the underlying tiddler value: changes to the tiddler are instantly reflected, and any edits are instantly propogated.
By default, applying the EditTextWidget to the text field of a tiddler will generates an HTML <textarea> element, i.e. a multi-line editor. Applying the EditTextWidget to any other field generates an HTML <input type="text"> element, a single-line editor. This behaviour can be overridden with the tag and type attributes.
Content and Attributes
The content of the <$edit-text> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | The tiddler to edit (defaults to the current tiddler) |
| field | The field to edit (defaults to text). Takes precedence over the index attribute |
| index | The index to edit |
| default | The default text to be provided when the target tiddler doesn't exist |
| class | A CSS class to be assigned to the generated HTML editing element |
| placeholder | Placeholder text to be displayed when the edit field is empty |
| focusPopup | Title of a state tiddler for a popup that is displayed when the editing element has focus |
| focus | Set to "yes" or "true" to automatically focus the editor after creation |
| tabindex | Sets the tabindex attribute of the input or textarea to the given value |
| tag | Overrides the generated HTML editing element tag. For a multi-line editor use tag=textarea. For a single-line editor use tag=input |
| type | Overrides the generated HTML editing element type attribute |
| size | The size of the input field (in characters) |
| autoHeight | Either "yes" or "no" to specify whether to automatically resize textarea editors to fit their content (defaults to "yes") |
| minHeight | Minimum height for automatically resized textarea editors, specified in CSS length units such as "px", "em" or "%" |
| rows | Sets the rows attribute of a generated textarea |
Notes
One trap to be aware of is that the edit text widget cannot be used to edit a field of the tiddler that contains it. Each keypress results in the tiddler being re-rendered, which loses the cursor position within the text field.
Instead, place the edit text widget in a template that references the tiddler you want to modify.
For example, if you wanted the tiddler GettingStarted to edit the value of the "myconfig" field of the tiddler "AppSettings", you might do so by creating a separate tiddler "ChangeAppSettings" that contains the following:
<$edit-text tiddler="AppSettings" field="myconfig"/>And reference the template in any other tiddler (e.g. GettingStarted) with {{ChangeAppSettings}}.
This works when your use of the tiddler is not the AppSettings itself which would cause a recursion problem. In this latter case you have to save the fields to a temporary (or alternative) tiddler (sort of the reverse of above) like so:
<$edit-text tiddler="StoreAppSettings" field="myconfig"/>In short the EditTextWidget can not change properties of the tiddler it is embedded in or part of. It can only change fields of other tiddlers. One could use ShadowTiddlers to accomplish the field storage if needed.
Introduction
The edit widget provides a general purpose interface for editing a tiddler. It dynamically chooses the appropriate widget depending on the type of the tiddler (currently either the EditTextWidget or the EditBitmapWidget).
Content and Attributes
The content of the <$edit> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | The tiddler to edit (defaults to the current tiddler) |
| field | The field to edit (defaults to text). Takes precedence over the index attribute |
| index | The index to edit |
| class | A CSS class to be added the generated editing widget |
| tabindex | Sets the tabindex attribute of the input or textarea to the given value |
| purpose | if the list of input titles is empty then return a list consisting of a single constant string, otherwise return the original titles |
|---|---|
| input | a selection of titles |
| parameter | E = a string |
| output | the original input titles unless empty, in which case return a list with the single entry E |
New in: 5.1.20 See Conditional Operators for an overview.
[[HelloThereMissing]is[missing]else[yes]]
[[HelloThere]is[missing]else[yes]]
This method is useful if, for any reason, you should find your current TiddlyWiki instance is not saving (e.g. a plugin or a server has stopped working). It should work on just about any platform.
- Go to advanced search
- Goto the filter tab
- Enter the following filter text:
[!is[system]!sort[modified]limit[25]]- Check the list of tiddlers.
- Adjust the number "25" in the filter to make sure you found all your recently modified tiddlers
- Press the bucket with the up arrow [] which appears on the right
- A dialogue window will ask for a location to download a file called tiddler.json on your local drive, or depending on browser configuration, just alert you that such a file will be downloaded. Press save.
- The
tiddlers.jsonfile can be imported (tools in sidebar) or drag and drop the file on the top line of the story river of another TW .- You can (de)select specific tiddlers.
- Finally, press
import.
La edición básica de TiddlyWiki es una distribución sin modificar del núcleo de TiddlyWiki, sin otros plugins ni configuración adicional instalados.
Puede descargarse desde:
Si el botón no funciona, guarda este enlace: https://tiddlywiki.com/languages/es-ES/empty.html
Seguramente el navegador te pida que confirmes la descarga
| purpose | apply HTML encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with HTML encoding applied |
"HTML encoding" means replacing special HTML characters with the corresponding HTML entity:
&replaced with&<replaced with<>replaced with>"replaced with"
[[Title with <angle brackets>]] +[encodehtml[]]
[[Title with an & ampersand]] +[encodehtml[]]
| purpose | apply URI encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with URI encoding applied |
[[Title with Space]] +[encodeuri[]]
[[Title with Space]] [[Another title with Space]] +[encodeuri[]]
| purpose | apply URI component encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with URI component encoding applied |
See Mozilla Developer Network for details of the encodeURIComponent operation.
[[Title with Space]] +[encodeuricomponent[]]
[[Title with Space]] [[Another title with Space]] +[encodeuricomponent[]]
Usado como archivo único de HTML, TiddlyWiki5 permite encriptar el contenido mediante la Stanford JavaScript Crypto Library.
- En la pestaña Herramientas de la barra lateral, localiza el botón .
- Si el botón muestra la leyenda "Asignar contraseña", significa que el wiki no está encriptado. Pinchando el botón se abrirá el cuadro de diálogo que permite asignar la contraseña de cifrado
- Abre el archivo en un editor de texto para verificar que los datos están encriptados
- Al abrir el archivo en el navegador, se te pedirá la contraseña antes de mostrarte su contenido.
TiddlyWIki ofrece otras dos funciones de encriptación, sin relación con esta:
- La de asignar una contraseña para guardar en TiddlySpot, en la pestaña Servidor del panel de control
- La de utilizar autenticación básica estándar HTTP en Node.js mediante el comando server. Combinada con SSL, esta función ofrece el mismo nivel de cifrado de tráfico que tienes en servicios del tipo de Google o Dropbox, aunque no cifra los datos guardados en el disco.
Introduction
The encrypt widget renders a filtered list of tiddlers to an encrypted block with the password currently held in the PasswordVault. The encrypted block can subsequently be decrypted by the TiddlyWiki5 BootMechanism. See the EncryptionMechanism for more details.
Content and Attributes
The content of the <$encrypt> widget is ignored.
| Attribute | Description |
|---|---|
| filter | Filter defining the tiddlers to be included in the encrypted block. If not specified then all non-system tiddlers are used |
| purpose | select titles from the operand interpreted as a title list |
|---|---|
| input | ignored |
! input | a selection of titles |
| suffix | D = New in: 5.1.20 dedupe (the default) to remove duplicates, raw to leave duplicates untouched |
| parameter | L = a title list |
| output | the titles stored as a title list at L |
! output | those input titles that are not listed in L |
<$set name="myList" value="first [[second with a space]] third">
<$list filter="[enlist<myList>]">
...[enlist[one two three]addsuffix[!]]
[enlist[one one one]]
[enlist:raw[one one one]]
[enlist{$:/StoryList!!list}]
Introduction
The entity widget displays a specified HTML character entity.
Content and Attributes
The content of the <$entity> widget is not used.
| Attribute | Description |
|---|---|
| entity | The entity to display (eg, ×) |
TiddlyWiki on Node.js supports the following OS environment variables for specifying a delimited list of paths to search for plugins and editions:
TIDDLYWIKI_PLUGIN_PATH- Search path for ordinary pluginsTIDDLYWIKI_THEME_PATH- Search path for themesTIDDLYWIKI_LANGUAGE_PATH- Search path for languagesTIDDLYWIKI_EDITION_PATH- Search path for editions (used by the InitCommand)
Note: The delimiter may vary between operating systems. While on Windows a semicolon ; is used, Linux implements a colon :.
The additional paths should each point to folders structured like the equivalent directories in the TiddlyWiki5 GitHub repository: the plugin, theme and language directories contain publisher/pluginname/<files> while the edition directories contain editionname/<files>
For example:
TIDDLYWIKI_PLUGIN_PATH=~/MyPluginStore
tiddlywiki mywiki --build index| purpose | apply CSS escaping to a selection of titles through the CSS.escape() method / operation |
|---|---|
| input | a selection of titles |
| output | the input with CSS escaping applied through the CSS.escape() method |
See Mozilla Developer Network for details of the CSS.escape() operation.
| purpose | escape special characters used in regular expressions |
|---|---|
| input | a selection of titles |
| output | the input with escaping applied to special regular expression characters |
See Mozilla Developer Network for details of the regular expression syntax.
I collect my tw5 creations on-line as http://eucaly-tw5.tiddlyspot.com/
Available Plugins :
- TitleMe - Return in-place tiddler title, to link / show / edit the source tiddler
- QuickJump - Quick jump to tiddlers in story list
- FlexWidth - Flexibly tweak sidebar width for TiddlyWiki 5 (Inspired by TW5 tristate Sidebar)
- MatchFilter - returns matching text instead of a list of the tiddlers from FieldFilter
- PopupTagger - TagBar / TagTable with popup list of tags (Inspired by MonkeyTaggerMacro for TiddlyWiki classic)
{
"name": "MyStuff",
"description": "A description of this wiki",
"dependencies": {
"sax": "1.2.4",
"tiddlywiki": "*"
}
}<div class="tc-table-of-contents">
<<toc-selective-expandable "Contents">>
</div><div class="tc-table-of-contents">
<<toc-expandable "Contents" "sort[title]">>
</div>
Select a topic in the table of contents. Click the arrow to expand a topic.
<$macrocall
$name="toc-tabbed-external-nav"
tag="TableOfContents"
selectedTiddler="$:/temp/toc/selectedTiddler"
unselectedText="<p>Select a topic in the table of contents. Click the arrow to expand a topic.</p>"
missingText="<p>Missing tiddler.</p>"
/>
Select a topic in the table of contents. Click the arrow to expand a topic.
<$macrocall
$name="toc-tabbed-internal-nav"
tag="TableOfContents"
selectedTiddler="$:/temp/toc/selectedTiddler"
unselectedText="<p>Select a topic in the table of contents. Click the arrow to expand a topic.</p>"
missingText="<p>Missing tiddler.</p>"
/>{
"description": "My wiki",
"plugins": [
"tiddlywiki/tiddlyweb",
"tiddlywiki/filesystem"
],
"themes": [
"tiddlywiki/vanilla",
"tiddlywiki/snowwhite"
]
}
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
<handlers>
<add
name="httpplatformhandler"
path="*"
verb="*"
modules="httpPlatformHandler"
resourceType="Unspecified"
requireAccess="Script" />
</handlers>
<httpPlatform
stdoutLogEnabled="true"
stdoutLogFile=".\node.log"
startupTimeLimit="20"
processPath="C:\Program Files\nodejs\node.exe"
arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki --listen port=PORT path-prefix=/MyApp">
<environmentVariables>
<environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" />
<environmentVariable name="NODE_ENV" value="Production" />
</environmentVariables>
</httpPlatform>
</system.webServer>
</configuration>
Esta es una muestra de algunos interesantes ejemplos de uso de TiddlyWiki en la web.
Envía más ejemplos que encuentres para ampliar esta lista via GitHub o Twitter, o publícalas en el grupo
TriTarget.org by Devin Weaver
A personal website built with TiddlyWiki.
TriTarget.org is a name I came up with in high school. I was big into computer programming and wanted a company name that was kinda catchy. When I made a few programs in BASIC I would brand them with TriTarget as a way to show off my company (Even though I didn't have one).
PESpot Lesson Planner by Patrick Detzner
Sistema para crear planes docentes, construido con TiddlyWiki
Construí un programa que sirviera de ayuda para la redacción y planifiación de leciones y que automatizara algunas de las tediosas tareas envueltas en la creación de un plan dociente. <<<
Obadiah TOC
Introducción de Dave Gifford al libro bíblico de Abdías, que usa la macro Índice y varios ajustes personalizados de TiddlyWiki: botones "nuevo aquí", esta plantilla personalizada de visualización para añadir notas e imágenes dentro de cualquier tiddler y un tiddler de transclusión para facilitar la impresión (este tiddler)
Simple Zork-like Game by Jed Carty
Juego sencillo, construido en TiddlyWiki, presentado en A simple game built with TiddlyWiki, presentado en este post.
http://zorklike.tiddlyspot.com
Quise ver si era posible hacer algún tipo de juego usando sólo el núcleo de TiddlyWiki, sin plugins ni JavaScript. Hice una versión muy esquemática de juego de ficción al estilo de Zork. Es lo más sencillo que se puede hacer y que se pueda llamar juego, pero puede que le añada cosas más adelante. Lo hice en la versión 5.1.5 prerelease, porque el widget action-setfield ahorra mucho tiempo de definir macros.
Una de las finalidades es no usar nada más que lo que contiene el núcleo de TiddlyWiki, tal cual: sin usar JavaScript ni plugin alguno.
Interactive Git Documentation by Devin Weaver
Guía para arreglar un repositorio roto de Git, al estilo elige tu propia aventura
http://sukima.github.io/GitFixUm/
Este documento es un intento de hacer una guía bastante exhaustiva para recuperar un repositorio de Git de lo que no tenías intención de hacer.
No es que Git sea tan complicado que necesites todo un libro para resolver tu problema en particular, sino que el abanico de cosas que puedes haber hecho para armar lío es tan grande, que se necesitan varias técnicas para solucionarlo, dependiendo de qué hayas hecho y de qué querías hacer.
"PETTIL - Forth for the Commodore PET" by Charlie Hitselberger
Intérprete rápido de de Forth para el Commodore PET, escrito en lenguaje ensamblador 6502. El TiddlyWiki que contiene documentación del programa se genera automáticamente de la fuente: ver: https://github.com/chitselb/pettil.
http://chitselb.com/files/tiddlypettil.html
Los objetivos del proyecto son, sin ningún orden en particular:
- hacer un Forth que funcione en mi Commodore PET 2001
- divertirme
- desarrollar mi pericia con el "6502 assembly golf"
- encontrar otra gente interesada en este proyecto
"A Thesis Notebook" by Alberto Molina
Cuaderno de tesis basado en TiddlyWiki
Este es un ejemplo de cuaderno de tesis, construido sobre TiddlyWiki 5.0.8-beta.
TiddlyWiki es un gran programa creado por Jeremy Ruston. Te permite, entre otras cosas, tomar notas, organizar ideaas, guardar información y ver todas tus cosas de la forma que queres. Es una herramiente increíblemente flexible que puedes adaptar para que satisfaga casi todas tus necesidades.
Este TiddlyWiki ha sido adaptado para servir de cuaderno de notas de filosofía, centrado en autores, libros y artículos, conceptos y teorías, además de notas personales. Lo uso junto con Zotero, que es un programa de bibliografía. Ambos son proyectos gratuitos de código abierto. TiddlyWiki se puede descargar de https://tiddlywiki.com
| purpose | convert each number to exponential notation with N digits |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers converted to exponential notation with N digits |
New in: 5.1.20 See Mathematics Operators for an overview.
The exponential operator returns a string representation of the input number in exponential notation with the specified number of digits. If a number has more digits than requested, the number is rounded to the nearest number represented by the specified number of digits
123456789 +[exponential[4]]
123456789 +[exponential[13]]
1.23E23 +[exponential[90]]
The External Attachments Plugin provides support for importing tiddlers as external attachments. That means that instead of importing binary files as self-contained tiddlers, they are imported as "skinny" tiddlers that reference the original file via the _canonical_uri field. This reduces the size of the wiki and thus improves performance. However, it does mean that the wiki is no longer fully self-contained.
This plugin only works when using TiddlyWiki with platforms such as TiddlyDesktop that support the path attribute for imported/dragged files.
Por imágenes externas nos referimos en tiddlywiki a tiddlers que, en lugar de incrustarla, apuntan a la URI de una imagen. Se trabaja más rápido que con imágenes incrustadas, especialmente si el wiki contiene gran número de imágenes o imágenes muy grandes. Sin embargo, supone abandonar la política inicial de "único archivo" de TiddlyWiki.
Las imágenes esternas se usan en el navegador. Puede crearlas la configuración de Node.js al construir TiddlyWiki o pueden crearse manualmente en el navegador.
En qué consisten
Una imagen externa es un tiddler de imagen que contiene el campo _canonical_uri cuyo valor es la URI de la imagen en cuestión. La URI puede ser absoluta o relativa al documento HTML. El campo text de un tiddler se ignora o se omite cuando se proporciona URI canónica de una imagen externa.
Creación manual de imágenes externas
Para crear manualmente una imagen externa, simplemente crea un tiddler con el tipo apropiado de contenido y añade el campo _canonical_uri indicando la ruta actual a la imagen.
Creación de imágenes externas en Node.js
Para crear un archivo HTML estático de TiddlyWiki acompañado por una carpeta de imágenes externas referenciadas en el HTML
- Crea tiddlers de imagen en los WikiFolders, de la manera habitual
- Guarda las imágenes como archivos separados (por convención, en una subcarpeta llamada images)
- Externaliza los tiddlers correspondientes a cada imagen habilitando el campo _canonical_uri
- Guarda el archivo HTML principal
Las imágenes deben añadirse a la subcarpeta antes de externalizar los tiddlers. El campo _canonical_uri invalida el campo text del tiddler, lo que lleva consigo que cualquier ulterior intento de guardado fallará.
Como ejemplo, véase el target externalimages de la demo "tw5.com":
--savetiddlers [is[image]] images
--setfield [is[image]] _canonical_uri $:/core/templates/canonical-uri-external-image text/plain
--setfield [is[image]] text "" text/plain
--rendertiddler $:/core/save/all externalimages.html text/plainGuardar archivos separados de imagen
Para guardar las imágenes de un wiki en una subcarpeta images puede usarse el comando --savetiddlers de la siguiente manera:
--savetiddlers [is[image]] imagesExternalizar tiddlers de imagen
Se usan dos comandos --setfield: el primero establece el campo con valor derivado del título del tiddler. El segundo limpia el campo text.
--setfield [is[image]] _canonical_uri $:/core/templates/canonical-uri-external-image text/plain
--setfield [is[image]] text "" text/plainLa plantilla $:/core/templates/canonical-uri-external-image contiene:
<!-- This template is used to assign the ''_canonical_uri'' field to external images. Change the `./images/` part to a different base URI. The URI can be relative or absolute. --> ./images/<$view field="title" format="doubleurlencoded"/>
Uso de imágenes externas
No es posible editar una imagen externa directamente en el navegador, salvo para editar la URI de forma que apunte a otra imagen.
Más información sobre características específicas de TiddlyWiki:
- Imágenes externas
- InfoPanel
- Permalinks
- MathML
- Autoguardado
- Formatos de fecha
- Drag and Drop
- Perdurable
- Importing Tiddlers
- Carga diferida
- Modales
- Notificaciones
- Performance Instrumentation
- Modo Seguro
- Escalable
- Búsquedas
- StartupActions
- Editor toolbar
- Atajos de teclado
- Actualizaciones
- Using SVG
- Alertas
- Cifrado
- WebServer
- Audio
- Importación
- Uso de SVG's
...y por último, pero no por ello menos importante: TiddlyWiki es un raro y práctico ejemplar de quine
Federatial Limited is a software consultancy founded by JeremyRuston, the creator of TiddlyWiki. Federatial helps organisations explore new user interaction concepts through rapid prototyping of sophisticated web-based tools.
See https://federatial.com/ and https://twitter.com/federatial for more information.
Fetch one or more files over HTTP/HTTPS, and import the tiddlers matching a filter, optionally transforming the incoming titles.
--fetch file <url> <import-filter> <transform-filter>
--fetch files <url-filter> <import-filter> <transform-filter>
--fetch raw-file <url> <transform-filter>
--fetch raw-files <url-filter> <transform-filter>The "file" and "files" variants fetch the specified files and attempt to import the tiddlers within them (the same processing as if the files were dragged into the browser window). The "raw-file" and "raw-files" variants fetch the specified files and then store the raw file data in tiddlers, without applying the import logic.
With the "file" and "raw-file" variants only a single file is fetched and the first parameter is the URL of the file to read.
With the "files" and "raw-files" variants, multiple files are fetched and the first parameter is a filter yielding a list of URLs of the files to read. For example, given a set of tiddlers tagged "remote-server" that have a field "url" the filter [tag[remote-server]get[url]] will retrieve all the available URLs.
For the "file" and "files" variants, the <import-filter> parameter specifies a filter determining which tiddlers are imported. It defaults to [all[tiddlers]] if not provided.
For all variants, the <transform-filter> parameter specifies an optional filter that transforms the titles of the imported tiddlers. For example, [addprefix[$:/myimports/]] would add the prefix $:/myimports/ to each title.
Preceding the --fetch command with --verbose will output progress information during the import.
Note that TiddlyWiki will not fetch an older version of an already loaded plugin.
The following example retrieves all the non-system tiddlers from https://tiddlywiki.com and saves them to a JSON file:
tiddlywiki --verbose --fetch file "https://tiddlywiki.com/" "[!is[system]]" "" --rendertiddler "$:/core/templates/exporters/JsonFile" output.json text/plain "" exportFilter "[!is[system]]"The following example retrieves the "favicon" file from tiddlywiki.com and saves it in a file called "output.ico". Note that the intermediate tiddler "Icon Tiddler" is quoted in the "–fetch" command because it is being used as a transformation filter to replace the default title, while there are no quotes for the "–savetiddler" command because it is being used directly as a title.
tiddlywiki --verbose --fetch raw-file "https://tiddlywiki.com/favicon.ico" "[[Icon Tiddler]]" --savetiddler "Icon Tiddler" output.ico| purpose | filter the input by field |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a field |
| parameter | S = a possible value of field F |
| output | those input tiddlers in which field F has the value S |
! output | those input tiddlers in which field F does not have the value S |
If S is empty, field will match both of the following:
- tiddlers that don't contain field
F - tiddlers in which field
Fexists but has an empty value
The syntax of a filter step treats any unrecognised filter operator as if it was the suffix to the field operator. See the examples.
<$fieldmangler>
Add tag ''example'' to this tiddler (current)<$button message="tm-add-tag" param="example">{{$:/core/images/new-button}}</$button>
<br>
Remove tag ''example'' to this tiddler (current)<$button message="tm-remove-tag" param="example">{{$:/core/images/delete-button}}</$button>
</$fieldmangler>
<$fieldmangler tiddler="Hello World">
Add tag ''example'' to the Hello World tiddler<$button message="tm-add-tag" param="example">{{$:/core/images/new-button}}</$button>
<br>
Remove tag ''example'' to the Hello World tiddler<$button message="tm-remove-tag" param="example">{{$:/core/images/delete-button}}</$button>
</$fieldmangler>
Introduction
The field mangler widget manipulates the fields and tags of a tiddler. It does so in response to the following Messages:
| Message | Description |
|---|---|
| tm-remove-field | Remove the field specified in event.param |
| tm-add-field | Add the field specified in event.param |
| tm-remove-tag | Remove the tag specified in event.param |
| tm-add-tag | Add the tag specified in event.param |
Content and Attributes
The field mangler widget displays any contained content, and responds to Messages dispatched within it.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler to manipulate (defaults to the current tiddler) |
| purpose | select all field names of the input titles |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | all the field names contained in the input tiddlers |
Each input title is processed in turn. Its list of field names is retrieved (in no particular order) and then dominantly appended to the operator's output.
Introduction
The fields widget renders each field of a specified tiddler through a simple text template. A list of fields to exclude can be provided. It is used internally by TiddlyWiki5, notably by the FileSavingMechanism.
Template Handling
The provided template is rendered with the following special substitutions:
| Symbol | Substitution |
|---|---|
| $name$ | Field name |
| $value$ | Field value |
| $encoded_value$ | HTML encoded form of field value |
Content and Attributes
The content of the <$fields> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler from which the fields are to be displayed (defaults to the current tiddler) |
| template | Text of the template (see above) |
| exclude | Lists of fields to be excluded (defaults to "text") |
| stripTitlePrefix | If set to "yes" then curly bracketed prefixes are removed from titles (for example {prefix}HelloThere converts to HelloThere) |
The stripTitlePrefix attribute is used when building TiddlyWiki Classic; see editions/tw2 in the TiddlyWiki5 repo.
Una expresión de filtro corresponde al nivel más externo de la sintaxis de filtros. Consta de una o más instrucciones.
El input de una instrucción es, generalmente, la lista de todos los títulos de tiddlers no-ocultos del wiki, sin ningún orden en particular.
Un prefijo, sin embargo, puede cambiar las cosas:
- Si una instrucción no lleva los prefijos
+o-, su output se añade dominantemente al output del filtro. - Si una instrucción lleva el prefijo
-, su output se elimina del output del filtro, si estuviera presente. - Si una instrucción lleva el prefijo
+, recibe como input el output del filtro y lo lo reemplaza por el output de dicha instrucción. Toda instrucción posterior vuelve a recibir como input todos los títulos del wiki, salvo que también lleve el prefijo+.
Dicho en lenguaje técnico, claros y conciso:
| Instrucción | Interpretación | Output |
|---|---|---|
runA runB | suma de conjuntos | cumple A O B |
runA +runB | intersección de conjuntos | cumple A Y B |
runA -runB | diferencia de conjuntos | cumple A Y NO B |
A filter operator is a predefined keyword attached to an individual step of a filter. It defines the particular action of that step.
Important: Each first step of a filter run not given any input titles receives the output of [all[tiddlers]] as its input.
The following table lists all core operators, the most common ones marked ✓. The last column indicates whether an operator allows negation using the ! prefix. For specifics as to each operator's negated output please refer to its documentation.
| Operator | Purpose | ✓ | ! |
|---|---|---|---|
| all | find all titles of a fundamental category | ✓ | |
| backlinks | find the titles that link to each input title | ||
| contains | filter the input by searching list fields for a value | ! |
|
| count | count the number of entries in a list | ||
| days | filter the input by date | ! |
|
| each | select one of each group of input titles by field | ||
| eachday | select one of each group of input titles by date | ||
| else | if the list of input titles is empty then return a list consisting of a single constant string, otherwise return the original titles | ||
| enlist | select titles from the operand interpreted as a title list | ! |
|
| field | filter the input by field | ✓ | ! |
| fields | select all field names of the input titles | ||
| get | select all values of a field in the input titles | ||
| getindex | select all values of a data property in the input titles | ||
| has | filter the input by field existence | ✓ | ! |
| haschanged | filter the input by tiddler modification status | ! |
|
| indexes | select all data properties of the input titles | ||
| is | filter the input by fundamental category | ✓ | ! |
| join | join a list of strings together with the separator S |
||
| length | returns the lengths of each item in the list | ||
| links | find the titles linked to by each input title | ✓ | |
| list | select titles via a list field | ! |
|
| listed | find the titles that list the input titles | ||
| lookup | applies a prefix to each input title to yield the title of a tiddler from which the final value is retrieved | ||
| lowercase | returns each item in the list as lowercase | ||
| match | returns each item in the list that matches the operand string | ||
| minlength | filter items shorter than the specified minimum length | ||
| range | generate a range of numbers | ! |
|
| regexp | filter the input by pattern-matched field | ! |
|
| sameday | filter the input by date | ||
| search | filter the input by searching tiddler content | ✓ | ! |
| sentencecase | returns each item in the list with the first letter capitalised | ||
| split | returns each item in the list split into separate strings according to the specified separator S; duplicates are not removed |
||
| splitregexp | returns each item in the list split into separate strings according to the specified regular expression R |
||
| subfilter | select titles from the operand interpreted as a filter expression | ! |
|
| then | replace input titles by a constant string | ||
| title | select a single title | ✓ | ! |
| titlecase | returns each item in the list with each word capitalised | ||
| trim | returns each item in the list with whitespace trimmed from the start and end | ||
| uppercase | returns each item in the list as uppercase | ||
| Order Operators | |||
| after | find which input title follows a specified one | ||
| before | find which input title precedes a specified one | ||
| bf | same as rest |
||
| butfirst | same as rest |
||
| butlast | discard the last N input titles |
||
| first | select the first N input titles |
||
| last | select the last N input titles |
||
| limit | select the first or last N input titles |
✓ | ! |
| next | find which titles in a list field follow the input ones |
||
| nsort | sort the input by number field | ! |
|
| nsortcs | sort the input titles by number field, treating upper and lower case as different | ! |
|
| nth | select the Nth input title |
||
| order | selectively reverse the input list | ✓ | |
| previous | find which titles in a list field precede the input ones |
||
| rest | discard the first N input titles |
||
| reverse | reverse the order of the input titles | ||
| sort | sort the input by text field | ✓ | ! |
| sortan | sort the input by text field considering them as alphanumerics | ✓ | ! |
| sortcs | sort the input by text field, treating upper and lower case as different | ! |
|
| Listops Operators | |||
| allafter | discard all items except those after the marker | ||
| allbefore | discard all items except those before the marker | ||
| append | append a range of items from an array to the list | ||
| insertbefore | insert an item T into a list immediately before an item B |
||
| move | move marker N places in the list | ||
| prepend | prepend a range of items from an array to the list | ||
| putafter | move N trailing items after the marker | ||
| putbefore | move N trailing items before the marker | ||
| putfirst | move N trailing items to the head of the list | ||
| putlast | move N leading items to the tail of the list | ||
| remove | remove a list of titles specified in the operand from the input | ||
| replace | replace marker with N trailing items | ||
| sortby | sort the current list in the order of the list referenced in the operand | ||
| String Operators | |||
| addprefix | extend each input title with a prefix | ||
| addsuffix | extend each input title with a suffix | ||
| decodehtml | apply HTML decoding to a string | ||
| decodeuri | apply URI decoding to a string | ||
| decodeuricomponent | apply URI component decoding to a string | ||
| encodehtml | apply HTML encoding to a string | ||
| encodeuri | apply URI encoding to a string | ||
| encodeuricomponent | apply URI component encoding to a string | ||
| escapecss | apply CSS escaping to a selection of titles through the CSS.escape() method / operation | ||
| escaperegexp | escape special characters used in regular expressions | ||
| jsonstringify | apply JSON string encoding to a string | ||
| prefix | filter the input titles by how they start | ! |
|
| removeprefix | filter the input titles by how they start, deleting that prefix | ||
| removesuffix | filter the input titles by how they end, deleting that suffix | ||
| splitbefore | select a delimited prefix from each input title | ||
| stringify | apply JavaScript string encoding to a string | ||
| suffix | filter the input titles by how they end | ! |
|
| Mathematics Operators | |||
| abs | calculate the absolute value of a list of numbers | ||
| add | treating each input title as a number, add to each the numeric value of the operand | ||
| ceil | rounds a list of numbers up to the next largest integer | ||
| divide | treating each input title as a number, divide them by the numeric value of the operand | ||
| exponential | convert each number to exponential notation with N digits |
||
| fixed | convert each number to fixed point notation with N digits after the decimal point |
||
| floor | rounds a list of numbers to the largest integer less than or equal to each number | ||
| max | treating each input title as a number, take the maximum of its value and the numeric value of the operand | ||
| maxall | find the largest of a list of numbers | ||
| min | treating each input title as a number, take the minimum of its value and the numeric value of the operand | ||
| minall | find the smallest of a list of numbers | ||
| multiply | treating each input title as a number, multiply it by the numeric value of the operand | ||
| negate | calculate the negation of a list of numbers | ||
| precision | convert each number to a string with N significant digits |
||
| product | produce the product of the input numbers | ||
| remainder | treating each input title as a number, return the remainder when divided by the numeric value of the operand | ||
| round | rounds a list of numbers to the nearest integer | ||
| sign | return -1, 0 or +1 for a list of numbers according to whether each number is negative, zero, or positive | ||
| subtract | treating each input title as a number, subtract from each the numeric value of the operand | ||
| sum | produce the sum of the input numbers | ||
| trunc | truncates a list of numbers to their integer part, removing any fractional part | ||
| untrunc | rounds a list of numbers to the next integer with largest absolute value, that is, away from zero | ||
| Tag Operators | |||
| tag | filter the input by tag | ✓ | ! |
| tagging | find the tiddlers that have the input tags | ||
| tags | select all tags of the input tiddlers | ||
| untagged | discard any input titles that have tags | ! |
|
| Special Operators | |||
| commands | select the titles of all the Node.js commands | ||
| editiondescription | select the descriptions of the input editions | ||
| editions | select the names of all the TiddlyWiki editions | ||
| getvariable | select all values of variables named in the input titles | ||
| modules | select the names of all modules of the input module types | ||
| moduletypes | select the names of all TiddlyWiki module types | ||
| plugintiddlers | select all shadow titles in the input plugins | ||
| shadowsource | select the plugin titles that contain the input shadows | ||
| storyviews | select the names of all the story views | ||
| subtiddlerfields | select all fields present in the selected tiddlers within a plugin | ||
| variables | select the names of all the actively defined variables | ||
A typical step is written as [operator[parameter]], although not all of the operators need a parameter.
Most steps process the selection of titles that are supplied as their input, but a few construct an entirely new selection instead. For the exact rules, see Filter Syntax.
Los parámetros de un operador son valores que pueden ser:
- rígidos o a fuego
[tal cual]- El parámetro es el valor exacto y literal que aparece entre corchetes.
- flexibles
- indirectos
{tal cual}- El parámetro es el texto indicado por la referencia cuyo nombre se muestra entre llaves, es decir, el valor de determinado campo en un tiddler en concreto o el valor de una propiedad de determinado tiddler de datos.
- variables
<tal cual>- El parámetro es el valor actual de la variable cuyo nombre aparece entre comillas angulares simples. Los parámetros de macros no están soportados.
Una instrucción se compone de pasos y devuelve como output una selección que contribuye a una expresión mayor.
Los pasos se procesan de izquierda a derecha y el input del primer paso es el mismo que el de la instrucción de la que forma parte. En todos los demás pasos, el input corresponde al output del paso anterior.
El output de un paso depende de su operador:
- La mayoría de operadores obtienen su output a partir del input. Por ejemplo, muchos devuelven un subconjunto del input, cumpliendo así realmente con la función de "filtros", al reducir el output de la instrucción que los contiene. Estos operadores se llaman modificadores de selección.
- Unos pocos operadores, sin embargo, ignoran el input y generan un output independiente. A estos se les llama constructores de selección, porque construyen una selección totalmente nueva.
Un buen ejemplo de constructor es title. El output de [title[A]title[B]] es B, mientras que field es un modificador, por lo que [title[A]field:title[B] no genera output alguno.
Las tres últimas opciones del diagrama que se muestra más arriba coinciden con sintaxis del tipo HelloThere, "HelloThere", 'HelloThere' y "Filter Operators"y son abreviaturas de [title[...]].
Las opciones entrecomilladas existen como soporte para títulos que contengan corchetes, como "un tiddler [[[[inusual]]]]".
The quoted options exist to support titles that contain square brackets, as in "An [[[[Unusual]]]] Tiddler".
Un paso representa una operación única que se realiza dentro de un filtro.
En términos de programación, se parece a la llamada de una función en la que el input es un parámetro implícito. El output de un paso es una selección que contribuye a una instrucción y, por lo tanto, a la expresión que lo contiene en su totalidad.
El operador de un paso se obtiene de una lista predefinida de palabras clave, que puede extenderse mediante plugins. Todo operador no reconocido se trata como sufijo de field. Si se omite el operador, se lo considera por defecto como title.
Un sufijo es texto adicional –generalmente el nombre de un campo– que complementa el significado de ciertos operadores.
Muchos pasos requieren un valor explícito de parámetro, llamado también operando, que concreta lo que tiene que hacer.
- Los filtros siguen una gramática especial que aquí presentamos mediante diagramas sintácticos, para uso de quienes encuentran útil la descripción sintáctica formal. Puedes, sin embargo, aprender a escribir filtros sin necesidad de comprender esta sección.
Un filtro es una una secuencia de instrucciones que transforma un input o "entrada" en un output o "salida". Tanto el input como el output son conjuntos ordenados de títulos de cosas tales como tiddlers y campos.
Un filtro es una expresión construida con piezas más pequeñas –que llamamos instrucciones y pasos–, cada uno de los cuales transforma a su vez un input en un output.
Un filtro comienza con un output vacío y sus ejecuciones se procesan de izquierda a derecha, modificando progresivamente dicho output.
Estas son las diferentes piezas que componen un filtro:
Entre las diferentes instrucciones de una expresión pueden aparecer diferentes caracteres en blanco.
Piensa en TiddlyWiki como en una base de datos cuyos registros son tiddlers. Una base de datos proporciona los medios para encontrar entre sus registros aquellos que coinciden con un determinado patrón de búsqueda. La forma de hacerlo en TiddlyWiki es mediante filtros.
Un filtro es una expresión breve y concisa que describe a un conjunto de tiddlers llamado output o salida. Siempre que TiddlyWiki encuentra un filtro, calcula su output. De este modo, puede realizar determinadas tareas con esa selección de tiddlers en particular, como contarlos o hacer una lista con ellos.
El siguiente ejemplo especifica un filtro de búsqueda a la macro list-links para que muestre un listado de tiddlers cuyos títulos comienzan con la letra hache:
<<list-links "[prefix[H]]">>
Y este es su output:
- History of TiddlyWiki
- help
- HelpingTiddlyWiki
- Enlaces físicos y simbólicos
- HyperText Markup Language
- ¡Hola!
- HelloThumbnail
- TiddlyWiki Classic
- Desarrolladores
- Amable introducción
- TiddlyWiki ayudando
- Introducción a TiddlyWiki
- Qué hay de nuevo en 5.1.21
- European Meetup 2017
- TiddlyMap Plugin
- Hidden Setting: Tab Index for Edit-Inputs
- Hidden Setting: New-Image Type
- Hidden Setting: Filename for Save Wiki Button
- Hidden Setting: Template for Save Wiki Button
- Hidden Setting: Search Minimum Length
- Hidden Setting: Sync Polling Interval
- Hidden Setting: Tags Minimum Length
- Hidden Setting: ViewTemplate and EditTemplate
- Hidden Setting: Scroll Top Adjustment
- Ajuste oculto: Search AutoFocus
- Ajuste oculto: Retardo del teclado
- Ajustes ocultos
- Hard Linebreaks with CSS
- Hard Linebreaks with CSS - Example
- Height of text editor
- Banner para contribuciones en GitHub
- Estilos CSS con etiquetas
- How to apply custom styles
- How to build a TiddlyWiki5 from individual tiddlers
- How to change the sort order of sub-branches in a TOC macro
- How to create keyboard shortcuts
- How to Customize TiddlyDesktop
- How to embed PDF and other documents
- Exportación de tiddlers
- How to hide the author's and other fields with CSS
- Banner de fecha de última modificación
- How to widen tiddlers (aka storyriver)
- Añadir pestañas a la barra lateral
- How to turn off camel case linking
- HistoryMechanism
- Highlight
- HTML
- HTML Links in WikiText
- Hard Linebreaks
- Headings
- Horizontal Rules
El output cambiará en la medida en que cambie el wiki según se añadan y se eliminen tiddlers. En cualquier caso, TiddlyWIki lo volverá a calcular al vuelo, manteniendo así al día cualquier cuenta o lista basada en dicho filtro.
Búsqueda avanzada tiene una pestaña llamada Filtro, que facilita experimentar con filtros.
- Para saber más:
Introducción a la notación de filtros – Guía paso a paso
Sintaxis de filtros – Reglas detalladas para uso técnico
Operadores de filtro – métodos disponibles de búsqueda
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
| purpose | select the first N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | the first N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]first[]]
[list[Days of the Week]first[5]]
[tag[Filter Operators]!sort[title]first[]]
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
| purpose | convert each number to fixed point notation with N digits after the decimal point |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers converted to fixed point notation with N digits after the decimal point |
New in: 5.1.20 See Mathematics Operators for an overview.
The fixed operator returns a string representation of the input number that does not use exponential notation and has exactly the specified number of digits after the decimal place. The number is rounded if necessary, and the fractional part is padded with zeros if necessary so that it has the specified length.
| purpose | rounds a list of numbers to the largest integer less than or equal to each number |
|---|---|
| input | a selection of titles |
| output | rounds each of the input numbers to the largest integer less than or equal to the given number |
New in: 5.1.20 See Mathematics Operators for an overview.
Available character formatting includes:
`backticks`forcode()- Alternatively,
``double backticks allows `embedded` backticks``
- Alternatively,
''bold''for bold text ()//italic//for italic text ()__underscore__for underscored text ()^^superscript^^for superscripted text (),,subscript,,for subscripted text ()~~strikethrough~~forstrikethroughtext ()
See also: Code Blocks in WikiText
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns instead of just one straight listing. The following method creates an actual table structure and uses the nth operator to provide break points for the rows. It is not responsive, that is, it doesn't re-position to display fewer columns if the window is too small.
In the first, outer list structure you must provide a count to indicate at item number rows should occur. So, in the following example, each row breaks after 4 items, so the sequence is 1,5,9, etc. Note that this requires you to know in advance the maximum number of items there will be. There is also an internal limit that is set to n-1 items, where n is the number of columns you want.
Note also that you need to repeat the driving filter operator inside of the internal <$list> widget. Obviously this technique lends itself to a macro implementation.
For other table-making techniques see also:
- Formatting List Results as Tables with CSS - Variable Column Method
- Formatting List Results as Tables with CSS - Specified Columns Methods
Example code for a four-column table with fewer than 70 items
<table>
<$list filter="1 5 9 13 17 21 25 29 33 37 41 45 49 53 57 61 65" variable ="rows">
<$list filter="[tag[Filter Operators]limit[50]] +[nth<rows>]" variable="cell">
<tr>
<td> <<cell>> </td>
<$list filter="[tag[Filter Operators]limit[50]] +[allafter<cell>limit[3]]" variable="this">
<td> <<this>> </td>
</$list>
</tr>
</$list>
</$list>
</table>Result
| abs Operator | add Operator | addprefix Operator | addsuffix Operator |
| after Operator | all Operator | allafter Operator | allbefore Operator |
| append Operator | backlinks Operator | before Operator | bf Operator |
| butfirst Operator | butlast Operator | ceil Operator | commands Operator |
| contains Operator | count Operator | days Operator | decodehtml Operator |
| decodeuri Operator | decodeuricomponent Operator | divide Operator | each Operator |
| eachday Operator | editiondescription Operator | editions Operator | else Operator |
| encodehtml Operator | encodeuri Operator | encodeuricomponent Operator | enlist Operator |
| escapecss Operator | escaperegexp Operator | exponential Operator | field Operator |
| fields Operator | first Operator | fixed Operator | floor Operator |
| get Operator | getindex Operator | getvariable Operator | has Operator |
| haschanged Operator | indexes Operator | insertbefore Operator | is Operator |
| join Operator | jsonstringify Operator |
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns, instead of just one straight listing. This method uses ~CSS to set up listing as columns and assumes that you know how many columns you want. The method here is to create a style that reflects the number of columns you want your table to be in, and then apply that style to the resulting list output.
For other table-making techniques see also:
- Formatting List Results as Tables with CSS - Variable Column Method
- Formatting List Results as Tables (no CSS)
1) Create a tiddler for the columns tagged with $:/tags/Stylesheet, containing:
/* FOUR COLUMN MODE */
.fourcolumns {
display:block;
-moz-column-count:4;
-moz-column-gap:1em;
-webkit-column-count: 4;
-webkit-column-gap:1em;
}Note the various places you need to indicate the number of columns
2) Then format your output like this:
@@.fourcolumns
<$list filter="[tag[Filter Operators]]" variable="foo"><br>
<<foo>>
</$list>
@@Example showing partial list of filter operators
abs Operator
add Operator
addprefix Operator
addsuffix Operator
after Operator
all Operator
allafter Operator
allbefore Operator
append Operator
backlinks Operator
before Operator
bf Operator
butfirst Operator
butlast Operator
ceil Operator
commands Operator
contains Operator
count Operator
days Operator
decodehtml Operator
decodeuri Operator
decodeuricomponent Operator
divide Operator
each Operator
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns, instead of just one straight listing. This method uses CSS to set up listing as columns. It is responsive, that is, re-positioning to display fewer columns if the window is too small.
You don't directly specify a fixed number of columns but instead specify the max-width for the list (which could be a transclusion of the tiddler width) and the width for each item. It lists from left to right, then wraps to a new row.
For other table-making techniques see also:
- Formatting List Results as Tables with CSS - Specified Columns Methods
- Formatting List Results as Tables (no CSS)
Example listing using 50 existing TiddlyWiki tags
<div class="dynamic-table">
<$list filter="[has[tags]tags[]sort[title]first[50]]">
<span class="item">
<$transclude tiddler="$:/core/ui/TagTemplate"/>
</span>
</$list>
</div>Example stylesheet to use with listing
<style>
.dynamic-table {
max-width:700px; /* could transclude tiddler width instead */
-ms-box-orient: vertical; /* might be unnecessary */
display: -webkit-box;
display: -moz-box;
display: -ms-flexbox;
display: -moz-flex;
display: -webkit-flex;
display: inline-flex;
-webkit-flex-wrap: wrap;
flex-wrap: wrap;
flex-direction: row;
}
.item {
max-width:160px; min-width:160px;
flex: 0 0 2em; /* -grow, -shrink, -basis */
}
</style>Results
Para controlar cómo se muestra el texto de un tiddler, puedes usar un formateo especial que llamamos WikiText.
Formato simple
En su forma más simple, WikiText te permite usar funciones habituales en el proceso de textos como negrita, cursiva, listas y tablas. Por ejemplo:
At its simplest, WikiText lets you use familiar word-processing features like bold, italic, lists and tables. For example:
Jovencillo ''emponzoñado'' de ~~whisky~~ ¡Qué //figurota// `exhibe`!
… se muestra como:
Jovencillo emponzoñado de whisky ¡Qué figurota exhibe!
Working with Tiddlers
Se puede enlazar a otros tiddlers en WikiText usando corchetes dobles o aprovechando la función de enlace automático de las palabras en CamelCase:
Este es un enlace al tiddler HelloThere y, este otro, a [[Historia de TiddlyWiki|History of TiddlyWiki]]… se muestra como:
Este es un enlace al tiddler HelloThere y, este otro, a Historia de TiddlyWiki
Macros
Las macros permiten empaquetar fragmentos de WikiText de difícil ejecución o que se repiten con frecuencia, para así poder usarlos con facilidad y consistentemente.
Por ejemplo, esta es la definición de una macro que inserta un icono y da formato especial a a un texto usado como advertencia, por ejemplo, en un manual:
\define .warning(_)
<div class="doc-icon-block">
<div class="doc-block-icon">{{$:/core/images/warning}}</div>
$_$</div>
El código que la define hace referencia, en este caso, a clases definidas en la hoja de estilos del documento.
Para llamar una macro en WikiText, la escribimos entre dobles comillas angulares simples y con el texto al que queremos aplicarla entre comillas rectas: <<.warning "texto">>
El resultado tiene este aspecto:
WikiText avanzado
Las funciones avanzadas de WikiText te permiten generar listas automáticamente entre otras funciones interactivas como menús desplegables. De hecho, la interfaz entera de TiddlyWiki está escrita en WikiText, de modo que casi todo cuanto ves puede es adaptable para su uso en otros wikis.
Algunas de estas funciones avanzadas requieren el uso de código complejo. Por ese motivo TIddlyWiki incorpora varias macros que simplifican algunas tareas en la interfaz de usuario, como la creación de pestañas, tablas de contenido y listas.
Foros de discusión de TiddlyWiki.
Son listas de correo en las que hablamos de TiddlyWiki: pedimos ayuda, anunciamos la publicación de nuevas ediciones o de nuevos plugins, debatimos sobre nuevas características, o simplemente compartimos experiencias.
Puedes participar a través de la página web asociada, o suscribirte via mail.
Usuarios
No necesitas tener cuenta en Google para acceder al grupo. Suscríbete igualmente enviando un mail a:
Además, puedes participar en nuestras reuniones periódicas online
o síguenos en Twitter si quieres recibir las últimas noticias
Desarrolladores
Grupo de desarrollo de TiddlyWiki
No necesitas tener cuenta en Google para acceder al grupo. Suscríbete igualmente enviando un mail a:
Accede a nuestra página de desarrollo en GitHub y haz tu contribución.
Síguenos en Twitter si quieres estar al tanto de las últimas noticias
Las nuevas ediciones de TiddlyWiki, TiddlyDesktop y TiddlyFox se anuncian en los foros de discusión y en Twitter.
También puedes suscribirte al feed de versiones en GitHub
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
La edición completa de ~Tiddlywiki consta de todos los idiomas, temas y plugins disponibles. Su uso está previsto para pruebas, especialmente para el cambio de un idioma a otro.
La edición completa puede descargarse de:
A plugin to integrate the popular lunr.js search engine, giving TiddlyWiki much more sophisticated search capabilities:
https://hoelz.ro/files/fts.html
Provides an alternative search result list that orders results by search relevance and ignores differences in word forms (ex. tag vs tags).
On my personal wiki, I have the problem that there are terms I use across a lot of tiddlers, and sometimes I'll use different forms (such as the aforementioned tag vs tags). I wanted a plugin to allow me to find the tiddler I'm looking for quickly and didn't require me to worry about how I declined a noun or inflected a verb - so I wrote this plugin, which provides an alternative search list powered by lunr.js.
TiddlyWiki se ha diseñado teniendo en mente las necesidades de perdurabilidad del usuario.
Puesto que es OpenSource y no necesita infrastructura alguna, podemos asegurar que lo único que necesitarás para acceder a un archivo de TiddlyWiki, incluso en un futuro lejano, es un navegador HTML normal y corriente. Si estás hoy al inicio de tu carrera, puedes estar seguro de que podrás seguir usándolo cuando te jubiles.
TiddlyWiki5 can be used to generate static HTML representations of a TiddlyWiki that doesn't need JavaScript.
There is much flexibility in how the static HTML is generated. The following scenarios are all illustrated on https://tiddlywiki.com.
Wiki Snapshots and Tiddler Snapshots
You can explore a static representation of this TiddlyWiki at static.html. That file is a static snapshot of the current DefaultTiddlers. Any tiddlers that it links to are referred to via URLs of the form /static/HelloThere.html that point to static snapshots of individual tiddlers. The tiddler HTML files reference a static.css stylesheet file.
The following commands are used to generate the sample static version of the TiddlyWiki5 site:
--rendertiddlers [!is[system]] $:/core/templates/static.tiddler.html static text/plain
--rendertiddler $:/core/templates/static.template.html static.html text/plain
--rendertiddler $:/core/templates/static.template.css static/static.css text/plainThe first RenderTiddlersCommand generates the HTML representations of individual tiddlers, the second RenderTiddlerCommand saves the static version of the DefaultTiddlers, and the final RenderTiddlerCommand saves the stylesheet. (All the files are placed in the output folder of the wiki folder).
Wiki Snapshot with Internal Links
It is also possible to produce a single HTML file that contains static representations of tiddlers, and uses standard HTML anchor links to jump between them.
For example: alltiddlers.html
The example is built by the following commands:
--rendertiddler $:/core/templates/alltiddlers.template.html alltiddlers.html text/plain| purpose | select all values of a field in the input titles |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field |
| output | the values of field F in each of the input titles |
Each input title is processed in turn. If the corresponding tiddler contains field F, and the value of this field is not empty, then its value is appended to the output.
Unlike most other Filter Operators, the selection output by get can contain duplicates. To avoid duplicates, use each[F]get[F].
[all[current]get[draft.of]]
[get[tags]]
[each[tags]get[tags]]
| purpose | select all values of a data property in the input titles |
|---|
Each input title is processed in turn, and is ignored if it does not denote a data tiddler. If the tiddler contains property P, the value of that property is dominantly appended to the output.
[[$:/palettes/Vanilla]getindex[background]]
[all[shadows+tiddlers]tag[$:/tags/Palette]getindex[background]]
Este breve tutorial te enseña cómo guardar cambios en TiddlyWIki.
El video está un poco anticuado, pero esperamos poder ponerlo pronto al día.
Breves instrucciones para empezar a trabajar en las diferentes plataformas y configuraciones con las que TiddlyWiki es compatible. Aquí encontrarás una introducción algo más amena.
Solución de problemas:
- No intentes guardar cambios con la opción Archivo/Guardar o Guardar como del navegador: No funciona
Te interesa ver también:
- Cifrado explica cómo usar la función incorporada de cifrado para proteger tus contenidos con contraseña.
- Guardar en TiddlySpot, servicio gratuito que te permite usar TiddlyWiki online
- Guardar en TiddlyDesktop, aplicación para trabajar con TiddlyWiki en el escritorio
- También puedes descargar este TIddlywiki en su versión íntegra, con toda su documentación:
Si el botón no funciona, guarda el siguiente enlace:
https://tiddlywiki.com/languages/es-ES/index.html
El navegador puede pedirte que confirmes la acción antes de comenzar la descarga
Hay dos formas de usar TiddlyWiki en Android:
Con Firefox y TiddlyFox
También puedes consultar el video tutorial
- Asegúrate de que tienes la última versión de Firefox para Android
- Descarga e instala la última versión de la extensión TiddlyFox de:
- Instala esta extensión para poder guardar localmente el archivo TiddlyWiki:
- Descarga un TiddlyWiki en blanco guardando el enlace:
Para guardar el enlace, mantenlo presionado y selecciona "Save link" (asegúrate de tener instalada la extensión "save-link-menus")
- Cuando se haya descargado el archivo, haz click en él, bien en la barra de notificaciones, bien en el administrador de descargas.
- Para abrirlo, selecciona Firefox en vez del navegador por defecto de Android.
- Haz clic en OK cuando TiddlyFox te pregunte si quieres activar la función de guardado para el archivo.
- Comprueba que funciona con el botón Nuevo tiddler de la barra lateral. Escribe algo en el tiddler y haz click en el botón OK
- Guarda ahora los cambios haciendo click en el botón Guardar cambios de la barra lateral.
- Arriba a la derecha aparecerá una notificación en amarillo que dice Guardado
- Actualiza la ventana del navegador para comprobar que los cambios se han guardado correctamente.
Con AndTidWiki
La aplicación para dispositivos Android AndTidWiki permite editar y guardar cambios en TiddlyWiki5, incluso al trabajar offline, sin conexión de red.
Nota: AndTidWiki es un proyecto independiente de TiddlyWiki
En Google Chrome, TiddlyWiki sólo puede guardar cambios usando el módulo alternativo de guardado compatible con HTML5
Este método para guardar cambios es un poco rudimentario porque requiere intervención manual para cada acción de guardado. Tiene, sin embargo, la ventaja de que funciona en casi todos los navegadores de escritorio y en muchos navegadores móviles.
- Descarga un TiddlyWiki en blanco pulsando este botón
Si el botón no funciona, guarda este enlace: https://tiddlywiki.com/languages/es-ES/empty.html
Seguramente el navegador te pida que confirmes la descarga
- Localiza el archivo que acabas de descargar
- Puedes cambiarle el nombre, siempre que mantengas la extensión
.htmlo.htm
- Puedes cambiarle el nombre, siempre que mantengas la extensión
- Abre el archivo en el navegador
- Crea un nuevo tiddler usando el botón Nuevo tiddler de la barra lateral. Escribe algo en él y haz clic en el botón OK
- Guarda los cambios con el botón Guardar cambios de la barra lateral
- El navegador descargará una copia del wiki que incluye tus cambios.
- Localiza el archivo nuevo y ábrelo en el navegador
- Comprueba que los cambios se han guardado correctamente
Consejo: la mayoría de navegadores permiten la opción de especificar la localización de cada descarga, en lugar de descargar a la carpeta por defecto. Esta opción te permite "planchar" tu archivo con la nueva versión.
Como mejor funciona TiddlyWIki en Firefox es con la extensión TiddlyFox.
Si usas Firefox para Android, las instrucciones que necesitas son estas.
- Comprueba que tienes la última versión de Firefox
- Descarga e instala la última versión disponible de TiddlyFox
- Reinicia Firefox
- Descarga un TiddlyWiki en blanco pulsando este botón:
- Localiza el archivo que acabas de descargar
- Puedes cambiarle el nombre, pero mantén la extensión
.htmlo.htm
- Puedes cambiarle el nombre, pero mantén la extensión
- Abre el archivo en Firefox
- Dale a OK cuando TiddlyFox te pregunte si quieres activar la función de guardado para el archivo
- Crea un nuevo tiddler usando el botón Nuevo de la barra lateral. Escribe algo en él y haz clic en el botón OK
- Guarda los cambios con el botón Guardar de la barra lateral
- Recarga la página para comprobar que se han guardado correctamente los cambios
- Descarga e instala la extensión TiddlyIE:
- Reinicia Internet Explorer. Se te preguntará si quieres activar TiddlyIE
Puede que también te pida activar Microsoft Script Runtime
- Descarga un TiddlyWiki en blanco pulsando este botón
Si el botón no funciona, guarda este enlace: https://tiddlywiki.com/languages/es-ES/empty.html
Seguramente el navegador te pida que confirmes la descarga
- Localiza el archivo que acabas de descargar
- Puedes cambiarle el nombre, pero mantén la extensión
.htmlo.htm
- Puedes cambiarle el nombre, pero mantén la extensión
- Abre el archivo con Internet Explorer
- Crea un nuevo tiddler usando el botón Nuevo tiddler de la barra lateral. Escribe algo en él y haz clic en el botón OK
- Guarda los cambios con el botón Guardar cambios de la barra lateral. Internet Explorer abrirá un cuadro de diálogo para que confirmes que quieres guardar el archivo localmente.
- Recarga la página para comprobar que los cambios se han guardado correctamente
En Ejecutar como Aplicación HTA se describe un método alternativo para usar TiddlyWiki con Internet Explorer.
La aplicación para iPad e iPhone TWEdit permite editar y guardar cambios en TiddlyWiki5, incluso cuando se trabaja offline, sin conexión de red. Descárgala aquí.
Instrucciones de uso:
- Abre TWEdit
- Toca el título en el centro de la barra de herramientas en uso
- Aparecerá un cuadro de texto en el que puedes indicar una URL
- Escribe la URL
https://tiddlywiki.com/languages/es-ES/empty.html - Cuando se cargue el TiddlyWiki vacío, toca el icono Guardar (el segundo icono por la derecha, en la barra superior)
- Aparecerá un cuadro de alerta en el que debes indicar un nombre para el archivo local.
- Escribe el nombre que quieras usar para tu documento (siempre con la extensión
.html)
- Comprueba que funciona con el botón Nuevo tiddler de la barra lateral. Escribe algo en el tiddler y haz click en el botón OK
- Guarda ahora los cambios haciendo click en el botón Guardar cambios de la barra lateral.
- Aparecerá un mensaje de confirmación arriba a la derecha
Nota: TWEdit es un proyecto independiente de TiddlyWiki
- Descarga e instala Node.js desde la página oficial: http://nodejs.org
- Abre una terminal de línea de comandos y teclea:
npm install -g tiddlywiki(ver nota * más abajo)Si te da fallo, necesitas volver a ejecutar la orden como administrador:
sudo npm install -g tiddlywiki(Mac/Linux) - Comprueba que TiddlyWiki se ha instalado con el comando:
tiddlywiki --version - Si todo está bien, TiddlyWiki devolverá el número de versión (p. ej, en este caso, 5.1.21. Puede que también muestre alguna información complementaria, de depuración.
- Probemos a ponerlo en marcha:
tiddlywiki miwiki --init servercreará, en el mismo directorio en el que hayas abierto la consola, una carpeta llamada miwiki, con los componentes necesarios.tiddlywiki miwiki --serverpondrá en marcha TiddlyWiki, que podrás ver y editar en el navegador.- Abre el navegador y escribe http://127.0.0.1:8080/ (o localhost:8080) en la barra de direcciones.
- Crea y edita tiddlers del modo acostumbrado. Los cambios se guardarán automáticamente en la carpeta miwiki/tiddlers
- Para apagar TiddlyWiki, cierra el navegador y haz Ctrl-C en la línea de comandos (o ciérrala: la consola te advertirá de que al hacerlo matarás el proceso en marcha. Confirma y listo)
- # Como opción, puedes hacer una copia offline del wiki:
- Con TiddlyWiki abierto en el navegador, haz click en el botón Guardar cambios de la barra lateral
- Con TiddlyWiki apagado y desde el mismo directorio desde donde lo iniciaste, teclea el siguiente comando en la consola:
tiddlywiki --build index
Nota: El argumento
-ghace que TiddlyWiki se instale globalmente (es decir, en todo el equipo). Sin él, TiddlyWiki estará disponible únicamente en el directorio desde el que lo instales.Si usas Debian o un sistema basado en Debian y recibes un mensaje del tipo
node: command not foundpese a haber instalado node.js, puede que necesites crear un enlace simbólico entrenodejsynode. En tal caso, consulta el manual de tu distribución de Linux ywhereis(más información sobre este comando) para crearlo correctamente (ver también issue 1434 en GitHub).Ejemplo en Debian v8.0:
sudo ln -s /usr/bin/nodejs /usr/bin/node
TiddlyWiki can also be hosted on online services such as Dropbox and Cloudant.
- Dropbox (syncs the entire HTML file)
- To edit files stored in your Dropbox, go to http://tiny.cc/tw5inthesky/. This will allow you to open any HTML files found.
- Cloudant (or another CouchDB-type server) (syncs individual tiddlers)
- http://noteself.github.io/
En Safari, TiddlyWiki sólo puede guardar cambios de forma manual, valiéndose para ello del módulo alternativo de guardado compatible con HTML5.
Este método para guardar cambios es un poco rudimentario porque requiere intervención manual para cada acción de guardado.
- Descarga un TiddlyWiki en blanco pulsando este botón
Si el botón no funciona, guarda este enlace: https://tiddlywiki.com/languages/es-ES/empty.html
Seguramente el navegador te pida que confirmes la descarga
- Localiza el archivo que acabas de descargar
- Puedes cambiarle el nombre, siempre que mantengas la extensión
.htmlo.htm
- Puedes cambiarle el nombre, siempre que mantengas la extensión
- Abre el archivo en el navegador
- Crea un nuevo tiddler usando el botón Nuevo tiddler de la barra lateral. Escribe algo en él y haz clic en el botón OK
- Guarda los cambios con el botón Guardar cambios de la barra lateral
- Se mostrará una ventana emergente Descargar cambios, con un enlace con el nombre Clic-derecho para guardar cambios
- Haz clic con el botón derecho y selecciona Descargar destino como... (u opción parecida) en el menú desplegable
- Ve hasta la carpeta que contiene el archivo HTML de tu wiki y selecciona el archivo
- Clic en el botón Guardar
- Clic en Reemplazar para confirmar la sustitución del archivo existente
- Comprueba que los cambios se han guardado correctamente
| purpose | select all values of variables named in the input titles |
|---|---|
| input | a selection of varible names |
| parameter | ignored |
| output | the values of each of the variables named in the input titles (or blank if the variable is not defined) |
New in: 5.1.20 The usual way to retrieve a variable value within a filter is with the angle brackets notation. For example, [<currentTiddler>] will retrieve the value of the variable called currentTiddler.
The getvariable filter operator provides an alternative way to retrieve a variable. For example, [[currentTiddler]getvariable[]] is another way to retrieve the value of the variable currentTiddler.
The advantage of getvariable is that it makes it possible to work with variables whose name is computed, and not known in advance. For example, [<myvariable>getvariable[]] gets the value of the variable whose name is given in the variable myvariable.
[[currentTiddler]getvariable[]]
GitHub is a hosting service for distributed projects that use git as their version-control system. It allows free hosting and management of open-source projects and facilitates collaborative developement on the source code. Using GitHub for non-open-source endeavors requires additional fees.
The code and documentation of TiddlyWiki is hosted on GitHub at:
https://github.com/Jermolene/TiddlyWiki5
GitHub also offer a free web hosting service called GitHub Pages that can be used directly from the single file configuration. See Saving to GitHub.
| en-GB | es-ES | Comentario |
|---|---|---|
| Tiddler | Tiddler | Invariable |
(Véase el capítulo de tablas para saber cómo editar el glosario)
¡Importante!! - Palabras y referencias reservadas para el sistema
- Nombres de
campoy sus referencias (nombre del campo, sin separador, seguido de Field. P. Ej.:ListField) - Nombre de widgets. P. Ej.: NavigatorWidget
The following sidebar tabs give examples of grouped lists created by nesting.
Types Tab
For the Types tab, the outer list filter as shown below selects each discrete value found in the type field. The inner list filter selects all the (non-system) tiddlers with that type.
<$list filter={{$:/core/Filters/TypedTiddlers!!filter}}>
<div class="tc-menu-list-item">
<$view field="type"/>
<$list filter="[type{!!type}!is[system]sort[title]]">
<div class="tc-menu-list-subitem">
<$link to={{!!title}}><$view field="title"/></$link>
</div>
</$list>
</div>
</$list>
Recent Tab
The list in the Recent tab is generated using the timeline macro. Here, the outer list filter selects each discrete day found in the modified field, while the inner list filter selects all the tiddlers dated the same day in the modified field.
\define timeline-title()
<!-- Override this macro with a global macro
of the same name if you need to change
how titles are displayed on the timeline
-->
<$view field="title"/>
\end
\define timeline(limit:"100",format:"DDth MMM YYYY",subfilter:"",dateField:"modified")
<div class="tc-timeline">
<$list filter="[!is[system]$subfilter$has[$dateField$]!sort[$dateField$]limit[$limit$]eachday[$dateField$]]">
<div class="tc-menu-list-item">
<$view field="$dateField$" format="date" template="$format$"/>
<$list filter="[sameday:$dateField${!!$dateField$}!is[system]$subfilter$!sort[$dateField$]]">
<div class="tc-menu-list-subitem">
<$link to={{!!title}}>
<<timeline-title>>
</$link>
</div>
</$list>
</div>
</$list>
</div>
\end
TiddlyWiki makes a great GuerillaWiki in situations where it is not practical to use a traditional wiki.
For instance, in a corporate setting, persuading an over-worked IT department to install a Wiki server for you is seldom going to be possible overnight. And if your PC is locked down you can't install a conventional Wiki yourself. Equally, you can't go and use one of the public hosted Wiki services because your Information Security department would not allow all that corporate data to flow into an outside server.
TiddlyWiki slices through those barriers by being usable on virtually all PCs.
Un enlace físico o hard link es uno que puede reconocerse visualmente, examinando el texto en WikiText.
Un enlace es simbólico o soft link si:
- forma parte de una transclusión de otro tiddler
- proviene de una macro o una variable
- lo genera un widget cuyo atributo
toes una transclusión, macro o variable
The usual handling of paragraphs in wikitext causes single line breaks to be ignored, and double linebreaks to be interpreted as the end of a paragraph.
This behaviour isn't convenient when dealing with material that incorporates hard linebreaks - for instance, poetry. You can mark a block of content as containing hard line breaks like this:
"""
This is a line
and this is a new line
while this is yet another line
and this is the final one
apart from this one
"""Tiene este aspecto:
This is a line
and this is a new line
while this is yet another line
and this is the final one
apart from this one
... y su código HTML es:
<p>This is a line<br>and this is a new line<br>while this is yet another line<br>and this is the final one<br>apart from this one<br></p>
Since TiddlyWiki Version 5.1.16, it's possible to apply customs styles with data- attributes. see: How to apply custom styles
The Custom data-styles stylesheet tiddler contains the following definition:
[data-tags*="example-hardlinebreaks"] .tc-tiddler-body {
word-break: normal;
word-wrap: break-word;
white-space: pre-wrap;
}If rendered without the tag, the content of "Hard Linebreaks with CSS - Example" will be shown like this:
The following text is rendered without any special WikiText syntax. So most of the WikiText functionality will be accessible. This is a line and this is a new line while this is yet another line and this is the final one apart from this one
Open the tiddler to see the custom CSS rules applied: Hard Linebreaks with CSS - Example
The following text is rendered without any special WikiText syntax. So most of the WikiText functionality will be accessible.
This is a line and this is a new line while this is yet another line and this is the final one apart from this one
| purpose | filter the input by field existence |
|---|---|
| input | a selection of titles |
| suffix | S = New in: 5.1.14 optionally, the keyword field |
| parameter | F = the name of a field |
| output | without suffix » those input tiddlers in which field F has a non-empty valuesuffix field» those input tiddlers in which field F exists |
! output | without suffix » those input tiddlers in which field F does not exist or has an empty valuesuffix field» those input tiddlers in which field F does not exist |
[has[color]]
[tag[Concepts]!has[modified]]
[has:field[emptyfield]]
[all[current]!has:field[doesntexist]]
| purpose | filter the input by tiddler modification status |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | those input tiddlers that have been modified during this session |
! output | those input tiddlers that have not been modified during this session |
A tiddler is deemed to have been modified if it has been written back to the wiki since the start of the current TiddlyWiki session. If you edit a tiddler and immediately store it again without making any changes, that is enough to mark it as modified.
Headings are specified with one up to six leading ! characters:
! This is a level 1 heading
!! This is a level 2 heading
!!! This is a level 3 headingCSS classes can be assigned to individual headings like this:
!!.myStyle This heading has the class `myStyle`Tiene este aspecto:
This heading has the class myStyle
... y su código HTML es:
<h2 class="myStyle">This heading has the class <code>myStyle</code></h2>
¿Nunca has tenido la sensación de que no te cabe en la cabeza todo lo que tienes que recordar?
BIenvenido a TiddlyWiki, un bloc de notas no lineal único para capturar, organizar y compartir información compleja.
Úsalo para mantener tu lista de tareas, para desarrollar un ensayo o novela, o incluso para organizar tu boda. Toma nota de todo cuanto te pase por la cabeza o construye una web flexible y ágil, que satisfaga tus necesidades.
Al revés que los servicios online convencionales, TiddlyWiki te deja escoger dónde quieres guardar tus datos, garantizándote que, por más que pase el tiempo, podrás seguir usando en el futuro las notas que tomes hoy.
Muestra ayuda para un comando:
--help [<command>]Si se omite el comando, se muestra una lista de comandos disponibles
If you find TiddlyWiki useful, there are lots of ways you can help assure its future and make it better.
Teach and Tell
OpenSource projects like TiddlyWiki thrive on the feedback and engagement of users. TiddlyWiki becomes more useful to everyone as more and more people use it. So, if you find TiddlyWiki useful, spread the word. The best possible way to assure its future is for it to become a hundred times more popular than before.
- Tweet about TiddlyWiki: I love TiddlyWiki because...
- Star the TiddlyWiki5 GitHub Repository
- Display the TiddlyWiki Poster
Help improve the documentation and code
There are many ways you can contribute to TiddlyWiki:
- Writing tutorials
- Contributing to the documentation on tiddlywiki.com
- Making video screencasts
- Curating relevant links, hints and tips on a wiki
The main TiddlyWiki documentation and code lives on GitHub, and welcomes contributions:
New in: 5.1.19 When saving a TiddlyWiki using the button, the default file name used for saving is constructed using the Title of the TiddlyWiki as entered in the Control Panel, which is stored in the tiddler $:/SiteTitle.
The value used is in the form {{$:/SiteTitle}}.html. This causes the filename to be constructed from the site Title with a .html extension.
If a tiddler named $:/config/SaveWikiButton/Filename is created, the text in that tiddler will be used as the default file name used for saving the TiddlyWiki.
By default new images are created with the image-type jpeg
The hidden setting in $:/config/NewImageType can be set to another Image-Type which is used for new Image Tiddlers, like png
As part of navigating to a tiddler, TiddlyWiki scrolls the page so that the top of the tiddler lines up with the top of the browser window. This means that the upper part of tiddlers can be obscured when using custom position:fixed toolbars at the top of the window.
To adjust the scroll position to allow for the toolbar, add the CSS class tc-adjust-top-of-scroll to the toolbar. TiddlyWiki's scrolling mechanism will then dynamically adjust the scroll position by the height of that element.
Al abrir TiddlyWiki, el foco se sitúa por defecto en la barra de búsqueda. Si esto te ocasiona algún problema, puedes modificarlo cambiando el texto de true a false en el siguiente tiddler:
New in: 5.1.14 Controls the minimum length of a search string before results are displayed.
Defaults to "3".
Specifies the interval at which Syncadaptor synchronizes tiddlers between the server and the browser.
Defaults to "60000" (60 * 1000 ms = 1 min).
Changing needs restart to take effect.
The input fields of Tiddlers that are being edited can be assigned a tabindex value (preferably 1) so that the Tab key can be used to directly move the focus from one input to the next or backwards using shift-Tab
New in: 5.1.16 Tag Dropdown: Controls the minimum length of an input string before results are displayed.
Defaults to "0".
Determines the template used when saving via the "save wiki" page control button.
Defaults to $:/core/save/all.
You can change this setting to choose what is saved when the "save wiki" button is clicked.
Para asegurar que al escribir no haya errores de interpretación de las pulsaciones del teclado, TiddlyWiki retarda el procesamiento de cambios en el borrador durante un breve período. El valor por defecto de 400 ms da un nivel óptimo de respuesta en la mayoría de casos, pero no siempre es el más conveniente en dispositivos móviles de baja potencia.
Para modificar el tiempo de retardo, basta con cambiar el valor en milisegundos de este tiddler:
The configuration Tiddlers $:/config/ui/ViewTemplate and $:/config/ui/EditTemplate can be used to change the ViewTemplate respectively the EditTemplate used in the Story PageTemplate
Los ajustes de configuración de TiddlyWiki se exponen en el , pero algunos más avanzados no tienen interfaz propiamente dicha, por lo que, si es necesario, se editan directamente en los tiddlers de configuración.
Arrastra los siguientes enlaces a tu wiki para cambiar estos ajustes.
- Hidden Setting: Tab Index for Edit-Inputs
- Hidden Setting: Filename for Save Wiki Button
- Hidden Setting: Template for Save Wiki Button
- Hidden Setting: Search Minimum Length
- Hidden Setting: Sync Polling Interval
- Hidden Setting: Tags Minimum Length
- Hidden Setting: ViewTemplate and EditTemplate
- Hidden Setting: Scroll Top Adjustment
- Ajuste oculto: Search AutoFocus
- Ajuste oculto: Retardo del teclado
Desarrollado para programadores, el plugin Highlight permite aplicar colores a la sintaxis del texto.
These are personal reflections on the history and development of TiddlyWiki from JeremyRuston.
There is also a podcast discussing TiddlyWiki's backstory.
Origins of TiddlyWiki
Back in 1997 a colleague introduced me to Ward Cunningham's original wiki. I was impressed that something so powerful could fit into just 700 lines of Perl, and fascinated by the radical reimagining of security and permissions. Like many other developers, I took every opportunity I could to try out various wikis, and to explore their use at work.
The allure of the wiki for me was the feeling that it could eventually disrupt the prevailing paradigm of print-oriented documents and emails.
After watching people use wikis for a few years, I noticed that power users made extensive use of the ability to open multiple wiki pages at once in several browser tabs, making it easier for them to compare and review pages, to copy text between them and to act as a sort of queue of pages yet to be read.
I felt that this ability to manipulate multiple pages at once was central to the ability to refactor a wiki, and it is generally accepted that a wiki that is lovingly refactored tends to be more useful. And yet, standard wiki user interfaces have always been designed exclusively for the presentation and manipulation of single pages at once.
All of these thoughts came together when I saw GMail in April 2004, which used Ajax cleverly to blend individual emails into threaded conversations.
I started experimenting with HTML and JavaScript to explore the idea further. I'd had virtually no experience of either, just having put together some static pages and simple ASP sites in previous lives. Getting my head around these client-side technologies was painful; like everyone else, I was horrified to discover how appalling were the incompatibilities and inconsistencies of web programming.
Launch of TiddlyWiki
So, in September 2004 I released a primitive first version of TiddlyWiki. It was the smallest possible thing that demonstrated the idea: it was a simple, self-contained static 48KB HTML file.
The downside of writing the first version of TiddlyWiki in this way was that it made it completely impractical to use for editing - when you click 'save changes' it just pops up a window showing the data that would be saved if it were possible for an HTML page to write to the file system.
Much of the early feedback was that TiddlyWiki was neat, but that it would be more useful when it was possible to properly save changes. I was a little frustrated, as I thought I knew that it was impossible for an HTML file running in the browser to save changes to the local file system.
Within a few months I saw an experimental Firefox extension that enabled TiddlyWiki to save changes in the browser. Examining the code, I realised that the APIs that it used to write to the file system were actually available in ordinary HTML files - as long as they were loaded via a file:// URI.
I adapted the Firefox code into the core of TiddlyWiki, and soon added a similar ability for Internet Explorer (making use of an old ActiveX control that Microsoft distributed with Internet Explorer).
Growth of TiddlyWiki
A major milestone in the growth of TiddlyWiki was the creation of "GTDTiddlyWiki" by Nathan Bowers. He took the vanilla TiddlyWiki product and adapted it for the specific application of keeping track of tasks using the popular Getting Things Done methodology. GTDTiddlyWiki was an immediate hit, being enthusiastically greeted on websites like LifeHacker.
Over the next couple of years TiddlyWiki continued to grow in popularity, and gained new features and capabilities. Within a year I was able to support myself by performing bespoke development work on TiddlyWiki, notably working with wiki pioneer SocialText on the ability to synchronise changes with an online server
BT Acquisition
In May 2007, BT acquired Osmosoft, my consultancy company. It was an unusual decision to acquire a company with a single employee and a tiny trickle of revenue - Osmosoft didn't even own the intellectual property in TiddlyWiki since I had handed it over to UnaMesa to assure its future for the community.
BT's motivation was to help them understand community-based ecosystems. I joined the organisation as "Head of Open Source Innovation", taking responsibility for open source governance, and providing advice and expertise on how to participate in open soure communities.
Osmosoft and TiddlySpace
I built a team in BT under the name Osmosoft. Our purpose was to evangelise the benefits of open source, and to help other teams realise those benefits in practice. We also found that it was necessary to evangelise the use of the web in general, and web standards in particular.
Our approach was to focus on showing rather than telling. We worked with the TiddlyWiki community to extend the ecosystem and we built numerous internal systems for BT (some based on TiddlyWiki and some not).
Osmosoft's chief contribution to the TiddlyWiki community was the creation of TiddlyWeb and TiddlySpace. TiddlyWeb was a robust, internet scale server for tiddlers that could also compose TiddlyWiki views of those tiddlers. TiddlySpace was an attempt to package TiddlyWeb into a more directly usable form.
Leaving BT
By the end of 2011 I was increasingly feeling that I would be better placed to realise the potential of TiddlyWiki outside of the corporate confines BT. Accordingly, I left and started work as an independent developer, primarily working on a brand new reboot of TiddlyWiki in the shape of TiddlyWiki5.
Development of TiddlyWiki5
I worked on new release of TiddlyWiki from November 2011. As a programmer, working on "version 2.0" of something that I had already written is a very attractive proposition. It means that the requirements were fully understood, allowing me to focus on evolving the architecture needed to support the desired functionality.
The Future
Now that TiddlyWiki5 has finally left "beta" status behind, my hope is that it will have a long life. Because it only uses standard features of HTML5 and Node.js, there is no reason why it cannot be fully operational for many years to come. My goal is for it to last for at least 25 years.
Jeremy Ruston, 20th September 2014
The system tiddler $:/HistoryList keeps track of a list of tiddlers comprising the navigation history. Each time you click on a link to a tiddler, the title of the target tiddler is added to the top of the stack.
The history list is stored in JSON to allow additional details about the coordinates of the DOM node that initiated the navigation.
The history list also maintains the field current-tiddler that contains the name of the tiddler at the top of the stack. This field can be used like so:
<$list filter="[list[$:/StoryList]]" history="$:/HistoryList" storyview="pop">
<$button message="tm-close-tiddler" class="tc-btn-invisible tc-btn-mini">×</$button> <$link to={{!!title}}><$view field="title"/> <$reveal type="match" state="$:/HistoryList!!current-tiddler" text=<<currentTiddler>>>✓</$reveal></$link>
</$list>Which renders the same as the "Open" sidebar tab, with the addition of a tick against the tiddler that was last navigated to.
Empty Story
To display content when the story is empty, create $:/config/EmptyStoryMessage and enter the desired contents. The following would show the GettingStarted tiddler when all others are closed.
{{GettingStarted||$:/core/ui/ViewTemplate}}You can include a horizontal rule with three or more dashes on their own on a line:
---
Tiene este aspecto:
... y su código HTML es:
<hr>
Cuando editas un tiddler en https://tiddlywiki.com, aparece una pequeña banda de color rosa que te invita a editar la fuente del tiddler en GitHub.
Si usas Node.js, puedes reproducir este mismo efecto para tu propio TiddlyWiki, de la siguiente manera:
- Asegúrate de incluir el siguiente ajuste en el archivo
tiddlywiki.infode tu directorio:"config": { "retain-original-tiddler-path": true } - Copia el tiddler $:/ContributionBanner a tu wiki
- Haz los siguientes cambios:
- Modifica la URL del enlace en GitHub para que apunte a tu propio directorio
- Modifica la frase "¿Puedes ayudarnos a mejorar la documentación?" del modo que mejor convenza a los lectores para que contribuyan contigo.
- Ajusta convenientemente el enlace Mejorar la documentación de TiddlyWiki para que apunte en la dirección del tiddler que contiene las instrucciones.
Para crear una nueva pestaña en la barra lateral:
- Crea un tiddler nuevo y ponle la etiqueta de sistema $:/tags/SideBar
- Si vas a crear un sumario o tabla de contenidos, puedes usar la macro de sumario . Tienes un ejemplo en el propio índice de este sitio
- Por defecto se usa el título del tiddler como título de la pestaña, pero puedes puentearlo con el campo
caption - Para definir en qué orden tiene que aparecer la pestaña, puedes usar los campos
list-beforeylist-after, tal como se indica en Etiquetas- P. ej.: establece el valor de
list-aftercomo $:/core/ui/SideBar/Open para colocar tu pestaña inmediatamente después de la solapa Abiertos
- P. ej.: establece el valor de
At the moment there are several ways to apply custom styles.
Se pueden aplicar estilos personalizados a tiddlers con una pestaña particular definiendo una clase CSS con el nombre tc-tagged-<etiqueta>.
Por ejemplo: Para que una serie de tiddlers con la etiqueta VistaNocturna se muestren con un esquema de colores apropiado para leer con poca luz, tendremos que crear una hoja de estilos que defina la clase tc-tagged-VistaNocturna, del modo siguiente:
.tc-tagged-VistaNocturna {
background-color:black;
color: orange;
padding: 35px 35px;
}
.tc-tagged-VistaNocturna .tc-tiddler-body {
font-size: 1.5em;
}La clase tc-tagged-VistaNocturna se aplica a todo el tiddler y no sólo al texto. Si queremos referirnos sólo a una parte del tiddler, se puede habilitar el selector CSS, como hemos hecho aquí con .tc-tagged-NightReader .tc-tiddler-body.
Nótese que las etiquetas que contengan espacios o caracterres no alfanuméricos, para que CSS los interprete, tendrán que convertirse según la codificación URI, lo que hace que la clase CSS resultante sea difícil de predecir y más proclive a errores.
Por ejemplo:
| Etiqueta | Nombre de clase generado |
|---|---|
$:/mytag | tc-tagged-%24%3A%2Fmytag |
Doctor Who | tc-tagged-Doctor%20Who |
£35.23 | tc-tagged-%C2%A335.23 |
Aunque TiddlyWiki generará las etiquetas, para usarlas en la hoja de estilos se tendrá que usar la correspondiente equivalencia en código porciento:
.tc-tagged-Doctor\%20Who {
background-image: url(./tardis_back.svg);
background-repeat: no-repeat;
background-position: right;
color:#FBFBFB;
}Hay disponible una función en JavaScript para realizar la conversión:
$tw.utils.tagToCssSelector("$:/tags/Stylesheet")...que genera la siguiente respuesta:
tc-tagged-\%24\%3A\%2Ftags\%2FStylesheetFirst install TiddlyWiki as described in Installing TiddlyWiki on Node.js.
- Create an empty TiddlyWikiFolder
- Create a new folder in a convenient place (for example
~/MyWiki) - Create a file called
tiddlywiki.infocontaining the following text:{"themes": ["tiddlywiki/vanilla","tiddlywiki/snowwhite"]}
- Create a subfolder called
tiddlers- Alternatively, just copy the
editions/emptyfolder from the TiddlyWiki5 repo
- Alternatively, just copy the
- Create a new folder in a convenient place (for example
- Create individual TiddlerFiles in the
~/MyWiki/tiddlersdirectory - Execute the following command from the TiddlyWiki5 root directory to build a TiddlyWiki5 file from the tiddlers:
tiddlywiki ~/MyWiki --rendertiddler $:/core/save/all index.html text/plain
Imagine that you are using a Table of Contents macro similar to this:
<<toc-selective-expandable "TableOfContents" "sort[title]">>The sorting is fine for most cases, but you would like all your items tagged Journal to be sorted by the created field. How can you apply a separate sort order to just those sub-items tagged Journal?
The trick is to add a field to the parent tagging tiddler (i.e. Journal) that points to a different sort criteria. Let's call the field fuzzy, and populate it with the value created (created is the name of the field that contains a tiddler's creation date).
Now change your Table of Contents to look like this:
<<toc-selective-expandable "TableOfContents" "sort{!!fuzzy}">>Now your Table of Contents will sort by title everywhere, except for the children of the Journal tiddler, which will sort by the created date.
The downside to this trick is that you can't apply a reverse sort based on just one special field. If you reverse the sort order, it will be reversed everywhere.
The configuration mechanism is the same for both shortcut-types
A tiddler with the prefix $:/config/ShortcutInfo/ and a unique suffix appended, like my-shortcut, makes the new shortcut appear in the $:/ControlPanel within the Keyboard Shortcuts Tab. An optional description can be added within its text field
In the Keyboard Shortcuts Tab the key combination that should trigger the shortcut can be configured:
Look for the unique suffix defined for the new shortcut and click the button to open a popup that detects key combinations and shows the detected combination in its input field
The add shortcut assigns the key-combination to the shortcut
Depending on the chosen platform the configuration mechanism creates a tiddler with a specific nomenclature
$:/config/shortcuts/ + the shortcut suffix for shortcuts that will work on all platforms (operating systems)
$:/config/shortcuts-(mac/not-mac/windows/not-windows/linux/not-linux)/ + the shortcut suffix for shortcuts that will work on the chosen platform only or that will not work on the excluded platform
Examples
- $:/config/shortcuts/
my-shortcut - $:/config/shortcuts-mac/
my-shortcut - $:/config/shortcuts-windows/
my-shortcut - $:/config/shortcuts-linux/
my-shortcut - $:/config/shortcuts-not-mac/
my-shortcut - $:/config/shortcuts-not-windows/
my-shortcut - $:/config/shortcuts-not-linux/
my-shortcut
At this point the shortcut is defined and its actions can be configured
Using the Keyboard Widget
A
$keyboardwidget detects the key combinations pressed within aninputortextareafield within its scope. The$keyboardwidget needs to "embrace" theinputortextareafield and itskeyattribute either points to a configuration tiddler using the Key Descriptor Syntax or explicitely contains the key
<$keyboard key="((my-shortcut))" actions='<$action-setfield $tiddler="my-tiddler" $field="my-field" $value="my-value"/>'>
<$edit-text tag="input" tiddler="my-tiddler"/>
</$keyboard><$keyboard key="alt-shift-M" actions='<$action-setfield $tiddler="my-tiddler" $field="my-field" $value="my-value"/>'>
<$edit-text tag="input" tiddler="my-tiddler"/>
</$keyboard>If actions are defined , the
$keyboardwidget will invoke the actions defined in itsactionsattribute when it detects the key-combination defined in itskeyattribute being pressed in anyinputortextareafield within its scope
Using global Keyboard Shortcuts
The actions for global keyboard shortcuts are stored in the text field of tiddlers tagged with
The key field connects an action-tiddler with the corresponding shortcut through the
((my-shortcut))syntax, called Keyboard Shortcut Descriptor
Syntax:
((+a chosen suffix+))
If the tiddler has the tag , the field key with the Keyboard Shortcut Descriptor as its value and some actions in its text field, the actions will be triggered when the mechanism detects the configured key-combination
\import $:/core/ui/PageMacros [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of]]
If the tiddler that contains the macro definition is known and - for example - titled my-macro-tiddler
\import my-macro-tiddler
Widgets
$action-navigate (ActionNavigateWidget)
Messages
WidgetMessage: tm-cancel-tiddler
WidgetMessage: tm-close-all-tiddlers
WidgetMessage: tm-close-other-tiddlers
WidgetMessage: tm-close-tiddler
WidgetMessage: tm-delete-tiddler
WidgetMessage: tm-edit-tiddler
WidgetMessage: tm-import-tiddlers
WidgetMessage: tm-new-tiddler
WidgetMessage: tm-perform-import
WidgetMessage: tm-rename-tiddler
WidgetMessage: tm-save-tiddler
Prelude/caution:
Before experimenting with TiddlyDesktop internals you should find the location of the “user configuration folder” - click the “Settings” button on the main TiddlyDesktop window, and then click the button “Open user config folder”. Then move up to locate the parent folder, which should be called “TiddlyDesktop”. If things go wrong, you can reset TiddlyDesktop to its factory state by deleting this entire folder.
Click the Backstage button on the main TiddlyDesktop window to open the backstage wiki. This is is a Node.js-like instance of TiddlyWiki that runs the UI and logic of TiddlyDesktop.
How do I get rid of the "Add a TiddlyWiki Folder" button.
Within the backstage wiki, locate the tiddler WikiListToolbar (there’s a link in HelloThere). Click it into edit mode and you’ll see the wikitext for all the toolbar buttons. If you make modifications and click “done” then the changes will immediately be reflected in the main TiddlyDesktop window.
How would I change the "advanced" button to the "reveal backups" button.
You can copy the code for the “reveal backups” button from the tiddler $:/TiddlyDesktop/Settings and paste it into WikiListToolbar.
How do I change the colors?
Just as usual in TiddlyWiki: you can use the palette, or define your own custom CSS.
How do I change the order in which the tiddlers are listed (which appears to be alphabetical)?
Open the WikiList tiddler, edit it, and scroll to the end. Then change the <$list> widget inside the wikilist macro:
<$list filter="[tag[wikilist]sort[title]!has[draft.of]]" emptyMessage="Add a ~TiddlyWiki file or folder to get started. Click the buttons above to browse, or drag and drop from your file Explorer/Finder" storyview="pop">Note about embedding versus external linking
Note: Before we dive into how you can embed files of a certain type, you may want to consider not embedding and instead simply linking to external resources like this:
[ext[title|path/to/that.file]] Then let your browser decide how to handle the resource. The advantage to this approach is that it is simple and quick. The disadvantage is that the file doesn't actually travel with the TW5 file and that you can't use node.js with method #2 below to quickly file paths.
Two ways to embed a PDF in your TW5 file.
1. Embedding with Drag and Drop
One is to drag and drop the file onto your TW5 file. Wait for the green bar to appear at the top, drop, and then import from the import tiddler. This actually embeds the contents of your imported PDF (or other file) into your TW5 file.
This method be OK as long as your PDF is not too big. There can be concerns if your TW5 file becomes too big.
2. Embedding with '_canonical_uri'
The other way is to create a tiddler link to the external file. In this method the file is not actually incorporated into your TW5 file, but can be accessed with the {{My Image File.jpg}} transclusion syntax just like an embedded file. The location address of the file can also be changed under node.js. See ExternalImages for details of using external images with node.js.
Create a tiddler with a field _canonical_uri. Put in the local address to the external file. Set the type field to application/pdf.
With either way, with an appropriately configured browser, you should see your embedded PDF file.
Other File Types
There's only so many file formats that TW5 knows about. There is a list at ContentType. If your browser and/or TW5 doesn't know what to do with a particular file format, then you can only the use the second method to embed and then download a file. When you edit the tiddler a link is presented. You can right click on the link in order to download the file.
Exportar todos los tiddlers
Para exportar todos los tiddlers del wiki, haz clic en la pestaña Herramientas de la barra lateral y a continuación selecciona el botón . Un menú desplegable te dará la opción de exportar los tiddlers en varios formatos.
Exportar un solo tiddler
Si quieres exportar un tiddler en particular, abre primero dicho tiddler y haz clic en el botón de la barra. De la lista desplegable que aparece, selecciona la opción . Un menú desplegable te mostrará las diferentes opciones de exportación disponibles.
Exportar tiddlers coincidentes con un criterio de búsqueda (filtros)
Para exportar una selección de tiddlers, haz clic en la lupa junto al área de de la barra lateral para abrir el tiddler de Búsqueda avanzada. Haz clic en la pestaña Filtro, que es la que te permite exportar una selección de tiddlers y escribe el criterio de búsqueda conforme a la sintaxis empleada por los filtros.
Una vez escrita la expresión de filtrado, aparecerá la lista de tiddlers coincidentes con el criterio de búsqueda. Entonces puedes hacer clic en el botón , a la derecha del campo de búsqueda. Un menú desplegable te ofrecerá las opciones de exportación disponibles.
Formatos de exportación
Actualmente, los formatos de exportación disponibles son:
- CSV
- JSON
- HTML estático
- archivo .tid
Sometimes you might want to save some screen space by hiding away the author's name in all tiddlers. Here's a quick way to do it:
- Create a new tiddler with any title you want.
- Give the tiddler the tag
$:/tags/Stylesheet - In the text field of the tiddler put:
.tc-subtitle .tc-tiddlylink {display:none;}- Save the tiddler. The author's name field should no longer appear.
Similarly, the entire subtitle field including author and date can be removed with:
.tc-subtitle {display:none;}Unfortunately, you can't hide just the date without also hiding the author using CSS.
And finally, for a truly minimalist look, you can remove the title with:
h2.tc-title {display:none;)Así es como se muestra la fecha de última modificación del wiki en un banner, en una esquina de la ventana:
- Instala el plugin Corner ribbon en TiddlyWiki.
- Guarda y recarga el wiki
- Crea un tiddler llamado $:/_MyRibbon, con la etiqueta $:/tags/PageControls y el siguiente contenido:
<div class="github-fork-ribbon-wrapper right">
<div class="github-fork-ribbon" style="background-color:#DF4848;">
<$list filter="[!is[system]!has[draft.of]!sort[modified]limit[1]]">
<$link>
<$view field="modified" format="date" template="DD mmm YYYY at 0hh:0mm"/>
</$link>
</$list>
</div>
</div>- Puedes cambiar el valor de
background-colorsegún tus preferencias - También puedes cambiar la posición de
rightaright-bottom- Para poner el banner a la izquierda, la etiqueta de MyRibbon debe ser $:/tags/PageTemplate en lugar de $:/tags/PageControls y la posición
left
- Para poner el banner a la izquierda, la etiqueta de MyRibbon debe ser $:/tags/PageTemplate en lugar de $:/tags/PageControls y la posición
CamelCase is used in most Wikis, but it can interfere with text presentation in some situations.
Turning off Camel Case locally
To turn off a particular instance of a CamelCase text, simply put a tilde (~) in front of the word, like this:
~CamelCaseTurning off Camel Case globally
To turn off CamelCase in all tiddlers, navigate to the Control Panel. Select the Settings tab and then scroll or read down to the Camel Case Wiki Links section and unselect Enable automatic CamelCase linking.
You can change the width of the main column of tiddlers (also known as the story river) by:
- Clicking on the settings cog to open the control panel
- In the control panel select "Appearance" and then "Theme Tweaks".
- Under Theme tweaks, scroll down.
There you will see settings for story right, story width, and tiddler width. By setting these numbers to something larger, you can widen the tiddlers. In general, story right and story width should be the same size, and tiddler width a little bit smaller. You could even use percentages for tiddler width. You will also probably want to change the sidebar breakpoint to something larger than the story river, unless you don't mind the sidebar floating to the top of the page.
HTML tags and comments can be used directly in WikiText. For example:
<article class="hello">
This is my nice and simple block of text. HelloThere
<!-- This comment will not appear in the wikified output -->
</article>Widgets share the same syntax as HTML tags, and so the following information applies to them, too.
Block mode versus Inline mode
To get the content of an HTML element to be parsed in block mode, the opening tag must be followed by two linebreaks.
Without the two linebreaks, the tag content will be parsed in inline mode which means that block mode formatting such as wikitext tables, lists and headings is not recognised.
Attributes
In an extension of conventional HTML syntax, attributes of elements/widgets can be specified in several different ways:
- a literal string
- a transclusion of a TextReference
- a transclusion of a macro/variable
- as the result of a Filter Expression
Literal Attribute Values
Literal attribute values can use several different styles of quoting:
- Single quotes (eg
attr='value') - Double quotes (eg
attr="value") - Tripe double quotes (eg
attr="""value""") - No quoting is necessary for values that do not contain spaces (eg
attr=value)
Literal attribute values can include line breaks. For example:
<div data-address="Mouse House,
Mouse Lane,
Rodentville,
Ratland."/>By using triple-double quotes you can specify attribute values that contain single double quotes. For example:
<div data-address="""Mouse House,
"Mouse" Lane,
Rodentville,
Ratland."""/>Transcluded Attribute Values
Transcluded attribute values are indicated with double curly braces around a TextReference. For example:
attr={{tiddler}}
attr={{!!field}}
attr={{tiddler!!field}}Variable Attribute Values
Variable attribute values are indicated with double angle brackets around a macro invocation. For example:
<div title=<<MyMacro "Brian">>>
...
</div>Filtered Attribute Values
Filtered attribute values are indicated with triple curly braces around a Filter Expression. The value will be the first item in the resulting list, or the empty string if the list is empty.
This example shows how to add a prefix to a value:
<$text text={{{ [<currentTiddler>addprefix[$:/myprefix/]] }}} />It is often useful to be able to create HTML links to external resources. For example, here the value of the href attribute will be set to the value of the tiddler MyLinkDestination:
<a href={{MyLinkDestination}}>link</a>However, there is an unexpected security issue that means that most of the time the link should have the rel attribute set to noopener noreferrer to maintain privacy of the URLs of private TiddlyWiki's (eg on Dropbox). See https://mathiasbynens.github.io/rel-noopener/ for more information.
<a href={{MyLinkDestination}} rel="noopener noreferrer">link</a>The image-picker macro displays an interactive image picker, as can be seen in the core text editor.
Parameters
- actions
- Wikitext for the action widgets that should be executed when the user selects an image. Within the text, the variable
imageTitlecontains the title of the tiddler containing the selected image. - subfilter
- An optional extra filter step, e.g.
tag[MyTag]
The images are selected by means of a filter expression, into which the subfilter parameter is spliced as follows:
[all[shadows+tiddlers]is[image]$subfilter$!has[draft.of]] -[type[application/pdf]] +[sort[title]]
Image: <$edit-text tiddler='$:/_MyImage' tag='input' placeholder='(unset)' default=''/>
<$transclude tiddler={{$:/_MyImage}}/>
---
<$macrocall $name='image-picker' actions="
<$action-setfield $tiddler='$:/_MyImage' $value=<<imageTitle>>/>
"/>This next example shows how the subfilter parameter limits the list of images (here to those with the "Language" prefix):
Image: <$edit-text tiddler='$:/_MyImage' tag='input' placeholder='(unset)' default=''/>
<$transclude tiddler={{$:/_MyImage}}/>
---
<$macrocall $name='image-picker' actions="
<$action-setfield $tiddler='$:/_MyImage' $value=<<imageTitle>>/>
" subfilter="prefix[Language]"/>
Este es un ejemplo de uso de ListWidget y TranscludeWidget para mostrar una cuadrilla de las imágenes del sistema (es decir, de tiddlers con la etiqueta $:/tags/Image).
Inserción y formato de imágenes
Se puede insertar y dar formato a imágenes con WikiText. La sintaxis para ello es la siguiente:
[img atributo [descripción|origen]]
Ejemplos:
| Acción | Sintaxis | Código de ejemplo | Resultado |
|---|---|---|---|
| Insertar imagen (origen interno) | [img[Título del tiddler con la imagen]] | [img[Motovun Jack.jpg]] | |
| Insertar imagen (origen externo) | [img[URL de la imagen]] | [img[https://tiddlywiki.com/favicon.ico]] | |
| Insertar imagen con descripción emergente | [img[descripción|origen]] | [img[Descripción emergente|Motovun Jack.jpg ]](Pasa el ratón por encima de la imagen para ver la descripción emergente) | |
| Insertar imagen con atributos | [img atributo[descripción|origen]] | [img width=100 [Motovun Jack.jpg]] | |
Los atributos pueden definirse directamente como el valor de clases CSS como ancho y altura o por transclusión o referencia de variables.
La sintaxis de imágenes en TiddlyWiki se compone de métodos abreviados para invocar ImageWidget.
Inserción de imágenes mediante transclusión de tiddlers
También puede mostrarse la imagen contenida en un tiddler por transclusión de este, escribiendo el título del tiddler entre llaves. Esto simplifica muchas veces la inclusión, pero tiene la desventaja de no poder controlar directamente el tamaño de la imagen.
{{Motovun Jack.jpg}} se muestra como:
Uso de imágenes externas
Por imágenes externas nos referimos en tiddlywiki a tiddlers que, en lugar de incrustarla, apuntan a la URI de una imagen. Se trabaja más rápido que con imágenes incrustadas, especialmente si el wiki contiene gran número de imágenes o imágenes muy grandes. Sin embargo, supone abandonar la política inicial de "único archivo" de TiddlyWiki.
Las imágenes esternas se usan en el navegador. Puede crearlas la configuración de Node.js al construir TiddlyWiki o pueden crearse manualmente en el navegador.
En qué consisten
Una imagen externa es un tiddler de imagen que contiene el campo _canonical_uri cuyo valor es la URI de la imagen en cuestión. La URI puede ser absoluta o relativa al documento HTML. El campo text de un tiddler se ignora o se omite cuando se proporciona URI canónica de una imagen externa.
Creación manual de imágenes externas
Para crear manualmente una imagen externa, simplemente crea un tiddler con el tipo apropiado de contenido y añade el campo _canonical_uri indicando la ruta actual a la imagen.
Creación de imágenes externas en Node.js
Para crear un archivo HTML estático de TiddlyWiki acompañado por una carpeta de imágenes externas referenciadas en el HTML
- Crea tiddlers de imagen en los WikiFolders, de la manera habitual
- Guarda las imágenes como archivos separados (por convención, en una subcarpeta llamada images)
- Externaliza los tiddlers correspondientes a cada imagen habilitando el campo _canonical_uri
- Guarda el archivo HTML principal
Las imágenes deben añadirse a la subcarpeta antes de externalizar los tiddlers. El campo _canonical_uri invalida el campo text del tiddler, lo que lleva consigo que cualquier ulterior intento de guardado fallará.
Como ejemplo, véase el target externalimages de la demo "tw5.com":
--savetiddlers [is[image]] images
--setfield [is[image]] _canonical_uri $:/core/templates/canonical-uri-external-image text/plain
--setfield [is[image]] text "" text/plain
--rendertiddler $:/core/save/all externalimages.html text/plainGuardar archivos separados de imagen
Para guardar las imágenes de un wiki en una subcarpeta images puede usarse el comando --savetiddlers de la siguiente manera:
--savetiddlers [is[image]] imagesExternalizar tiddlers de imagen
Se usan dos comandos --setfield: el primero establece el campo con valor derivado del título del tiddler. El segundo limpia el campo text.
--setfield [is[image]] _canonical_uri $:/core/templates/canonical-uri-external-image text/plain
--setfield [is[image]] text "" text/plainLa plantilla $:/core/templates/canonical-uri-external-image contiene:
<!-- This template is used to assign the ''_canonical_uri'' field to external images. Change the `./images/` part to a different base URI. The URI can be relative or absolute. --> ./images/<$view field="title" format="doubleurlencoded"/>
Uso de imágenes externas
No es posible editar una imagen externa directamente en el navegador, salvo para editar la URI de forma que apunte a otra imagen.
Introduction
The image widget displays images that can be specified as a remote URL or the title of a local tiddler containing the image.
Content and Attributes
Any content of the <$image> widget is ignored.
| Attribute | Description |
|---|---|
| source | The URL of the image, or the title of an image tiddler |
| width | The width of the image |
| height | The height of the image |
| tooltip | The tooltip to be displayed over the image |
| alt | The alternative text to be associated with the image |
| class | CSS classes to be assigned to the <img> element |
The width and the height can be specified as pixel values (eg "23" or "23px") or percentages (eg "23%"). They are both optional; if not provided the browser will use CSS rules to size the image.
External Images and the _canonical_uri field
When used to display tiddler-based images, the image widget operates in two distinct modes:
- If the _canonical_uri field is present then it is used as the src attribute of the generated
<img>element and the text field is ignored - Without the _canonical_uri field, the image widget generates an
<img>element that embeds the image data directly using adata:URI.
See ExternalImages for more details.
Import tiddlers from TiddlyWiki (.html), .tiddler, .tid, .json or other local files. The deserializer must be explicitly specified, unlike the load command which infers the deserializer from the file extension.
--import <filepath> <deserializer> [<title>] [<encoding>]The deserializers in the core include:
- application/javascript
- application/json
- application/x-tiddler
- application/x-tiddler-html-div
- application/x-tiddlers
- text/html
- text/plain
The title of the imported tiddler defaults to the filename.
The encoding defaults to "utf8", but can be "base64" for importing binary files.
Note that TiddlyWiki will not import an older version of an already loaded plugin.
You can import tiddlers into a TiddlyWiki from external files or directly from another TiddlyWiki.
Importing content from external files
There are several ways to import content from external files:
- Use the import button (under the Tools tab in the sidebar) to select a local file
- Drag and drop files from Windows Explorer or OS X Finder etc. into the TiddlyWiki browser window
- Paste content directly from the clipboard using the menu or keyboard shortcut (ctrl-V or cmd-V)
- Currently supported in Chrome, Firefox and Edge (but not Internet Explorer)
Most files are imported as individual tiddlers. The exceptions are:
- .html files that are recognised as a TiddlyWiki file are parsed to extract the tiddlers within them
- .json files are parsed to extract the tiddlers within them. They can be created by exporting them from another TiddlyWiki. TiddlyWiki accepts JSON files that contain either a single tiddler fields object, or an array of tiddler fields objects
Importing content from other TiddlyWiki browser windows
Tiddlers can be imported from other TiddlyWiki browser windows via Drag and Drop. Drag a tiddler link or tag from one TiddlyWiki browser window to another. Dragging a link will import a single tiddler while dragging a tag pill will import all of the tiddlers that carry that tag.
En TiddlyWiki puedes importar contenido de varias maneras:
- Usa el botón , en la pestaña Herramientas de la barra lateral para seleccionar un archivo local
- Arrastra archivos desde cualquier ventana de tu escritorio a la del navegador
- Copia contenido directamente del portapapeles mediante la opción del menú, o pulsando Ctrl+V/Cmmd+V
- Por el momento, únicamente Chrome/Chromium permite esta acción
Introduction
The ImportVariablesWidget imports macro and variable definitions from a list of other tiddlers and makes them available to its children. For example:
<$importvariables filter="[tag[mySpecialMacros]]">
All the macros defined in tiddlers with the tag "mySpecialMacros" are available here
</$importvariables>Attributes and Content
The content of the importvariables widget is the scope within which the imported variable definitions are available.
| Attribute | Description |
|---|---|
| filter | Tiddler filter defining the tiddlers from which macro definitions will be imported |
Global Macros
So-called global macros are implemented within the main page template ($:/core/ui/PageTemplate) by wrapping the page content in the following importvariables widget:
<$importvariables filter="[[$:/core/ui/PageMacros]] [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of]]">
...
</$importvariables>\import Pragma
New in: 5.1.18 The \import pragma is an alternative syntax for using the ImportVariablesWidget. For example, the previous example could be expressed as:
\import [[$:/core/ui/PageMacros]] [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of]Cualquiera puede proponer mejoras en la documentación de TiddlyWiki que aparece en https://tiddlywiki.com.
- Lee y sigue la Guía de estilo para documentación
- Date de alta en https://github.com
- Si no lo has hecho aún, firma el acuerdo de licencia de contribución
- En https://tiddlywiki.com, haz clic en el botón del tiddler que quieres mejorar
- Aparecerá un banner de color rosa con el texto Can you help us improve this documentation? Find out how to edit this tiddler on GitHub
- Haz clic en el enlace externo this tiddler on GitHub
- Se te indicará que necesitas hacer un fork del repositorio para poder proponer cambios. Un fork es una copia del repositorio que incluirá los cambios que propongas.
- Se abrirá una nueva ventana en el navegador, con el tiddler listo para editar en github.com
- Bajo la ventana de edición del tiddler, verás un cuadro titulado "Propose file change"
- Escribe un breve título que explique la naturaleza del cambio, p. ej.: "Sustitución de formato directo por estilos"
- Si es necesario, puedes desarrollarlo convenientemente más abajo
- Haz clic en el botón verde "Propose file change"
- En la página siguiente, pulsa el botón verde "Create pull request"
Jermolene u otro de los desarrolladores principales tendrán así la oportunidad de incorporar tus cambios en la próxima edición de https://tiddlywiki.com.
Mario Pietsch ha creado estos videotutoriales al respecto:
A plugin that allows changes to be synchronised with the IndexedDB database that is built-in to most browsers.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
| purpose | select all data properties of the input titles |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | all the property names or indices contained in the input data tiddlers |
Each input title is processed in turn, and is ignored if it does not denote a data tiddler. The list of property names is retrieved from the data tiddler (in no particular order) and then dominantly appended to the operator's output.
Where a tiddler's content is JSON with an array as its root, the indexes operator retrieves a selection of integer indices instead.
System tiddlers in the namespace $:/info/ are used to expose information about the system (including the current browser) so that WikiText applications can adapt themselves to available features.
Information Tiddlers
| Title | Description |
|---|---|
| $:/info/browser | Running in the browser? ("yes" or "no") |
| $:/info/browser/language | New in: 5.1.20 Language as reported by browser (note that some browsers report two character codes such as en while others report full codes such as en-GB) |
| $:/info/browser/screen/width | Screen width in pixels |
| $:/info/browser/screen/height | Screen height in pixels |
| $:/info/node | Running under Node.js? ("yes" or "no") |
| $:/info/url/full | New in: 5.1.14 Full URL of wiki (eg, ) |
| $:/info/url/host | New in: 5.1.14 Host portion of URL of wiki (eg, ) |
| $:/info/url/hostname | New in: 5.1.14 Hostname portion of URL of wiki (eg, ) |
| $:/info/url/origin | New in: 5.1.14 Origin portion of URL of wiki (eg, ) |
| $:/info/url/pathname | New in: 5.1.14 Pathname portion of URL of wiki (eg, ) |
| $:/info/url/port | New in: 5.1.14 Port portion of URL of wiki (eg, ) |
| $:/info/url/protocol | New in: 5.1.14 Protocol portion of URL of wiki (eg, ) |
| $:/info/url/search | New in: 5.1.14 Search portion of URL of wiki (eg, ) |
Cada tiddler contiene un panel oculto con información adicional. Para mostrarlo, haz clic en el botón en la barra del título y selecciona el botón en la lista desplegable.
El InfoPanel contiene las siguientes pestañas:
- Herramientas ofrece botones para realizar diferentes acciones. Puedes seleccionar el botón que quieras añadir a la barra del tiddler marcando la casilla que tiene al lado. Esto afectará a todos los tiddlers en el wiki.
- Referencias, Etiquetado, Lista y En lista de dan un listado de diferentes tipos de tiddlers relacionados con el actual. Ver uso de links para navegar entre tiddlers
- Campos da una lista de los campos contenidos en el tiddler, excepto
text - Avanzado indica si el tiddler es de tipo oculto. Si lo es, dice también de qué plugin forma parte y si está o no anulado por un tiddler común.
- Sources indica el origen, en el sitio de TiddlyWiki, de aquellos tiddlers que forman parte de la documentación oficial, donde se lo encuentra como página HTML estática. En tal caso, para facilitar contribuciones que mejoren la documentación, se muestra también la ruta del archivo original en GitHub.
Para cerrar el panel, basta con hacer clic fuera de él.
Inicializa una WikiFolder con una copia en blanco de la edición especificada.
--init <edition> [<edition> ...]Por ejemplo:
tiddlywiki ./MyWikiFolder --init emptyNota:
- Se creará un directorio para el wiki si es necesario
- La edición por defecto es empty
- El comando
--initfallará si el directorio no está vacío - El comando
--initelimina toda definición deincludeWikiscontenida en el archivotiddlywiki.info - Cuando se indican varias ediciones para su inicialización, las ediciones planchan sucesivamente todo archivo compartido, de modo que el
archivo tiddlywiki.info final será el que corresponda a la última edición que se indique.
--editionsmuestra una lista de ediciones disponibles
See also:
The Innerwiki Plugin enables TiddlyWiki to embed a modified copy of itself (an "innerwiki"). The primary motivation is to be able to produce screenshot illustrations that are automatically up-to-date with the appearance of TiddlyWiki as it changes over time, or to produce the same screenshot in different languages.
In the browser, innerwikis are displayed as an embedded iframe. Under Node.js Google's Puppeteer is used to load the innerwikis as off-screen web pages and then snapshot them as a PNG image.
See the demo at https://tiddlywiki.com/plugins/tiddlywiki/innerwiki
| purpose | insert an item T into a list immediately before an item B |
|---|---|
| input | a selection of titles |
| suffix | B = the name of a variable containing the title of the tiddler before which this one should be inserted |
| parameter | T = the title of the tiddler to insert |
| output | the input tiddler list with the new entry inserted |
If the item B isn't present in the input list then the new item is inserted at the end of the list.
Configuración de escritorio
Seguir instrucciones cuando se utiliza TiddlyWiki en versión archivo HTML:
- Sólo por si acaso, haz copia de seguridad de tu archivo HTML de TiddlyWiki
- Abre TiddlyWiki en el navegador
- Abre el panel de control , clic en la pestaña Plugins y luego en botón Obten complementos y extensiones
- Pincha en el botón Abrir biblioteca de complementos y extensiones para abrir la librería oficial
- Cuando se haya cargado la librería:
- Selecciona la pestaña adecuada al tipo complemento que buscas Plugins, Temas o Idiomas
- Desplázate o usa el cuadro para encontrar lo que buscas
- Pincha el botón instalar
- Guarda los cambios con el botón
- Recarga la página
- El plugin está instalado y listo para su uso
Configuración cliente-servidor
Seguir instrucciones cuando se utiliza TiddlyWiki en versión servidor Node.js:
- Identificar el plugin que desea instalar usando la pestaña Plugins en el panel de control ('sin embargo no instalar el plugin desde aquí). Los plugins se identifican por su tipo (Plugins, Temas o Idiomas), editor y título. Por ejemplo, el plugin
$:/plugins/tiddlywiki/internalses identificado como tiddlywiki/internals - Detener el servidor si está en ejecución.
- Editar el archivo
tiddlywiki.info(está en formato JSON) y ubicar la secciónplugins,themesorlanguages(ver abajo) - Agreagar las entradas correspondientes a los plugins que desea instalar. (Tener cuidado de separar los ítems con coma, pero al último ítem no colocarle)
- Reiniciar el servidor
{
"plugins": [
"tiddlywiki/codemirror"
],
"themes": [
"tiddlywiki/vanilla",
"tiddlywiki/snowwhite"
],
"languages": [
"es-ES",
"fr-FR",
"en-EN"
]
}Microsoft's Internet Information Server (IIS) is the built-in web server for Windows. It can be useful to host TiddlyWiki within IIS in order to take advantage of IIS features like URL rewriting, static file hosting and automatic restarts after a crash.
1. Enable IIS
- In Windows, access the Control Panel and click Add or Remove Programs
- In the Add or Remove Programs window, click Add/Remove Windows Components.
- Select the Internet Information Services (IIS) check box
- Click Next, then click Finish
2. Install the required tools
- Install the IIS module HttpPlatformHandler from https://www.iis.net/downloads/microsoft/httpplatformhandler
- Install Node.js from https://nodejs.org/
- Install Git from https://git-scm.com/
- optional; only required when using the latest TiddlyWiki release pulled directly from GitHub – see below
3. Install TiddlyWiki and setup a new wiki
- Create a convenient directory for the wiki (e.g.
C:\MyStuff) - Within it, create a file called
C:\MyStuff\package.jsonwith the content:{ "name": "MyStuff", "description": "A description of this wiki", "dependencies": { "sax": "1.2.4", "tiddlywiki": "*" } } - Also create a file called
C:\MyStuff\web.configwith the content:<?xml version="1.0" encoding="UTF-8"?> <configuration> <system.webServer> <handlers> <add name="httpplatformhandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified" requireAccess="Script" /> </handlers> <httpPlatform stdoutLogEnabled="true" stdoutLogFile=".\node.log" startupTimeLimit="20" processPath="C:\Program Files\nodejs\node.exe" arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki --listen port=PORT path-prefix=/MyApp"> <environmentVariables> <environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" /> <environmentVariable name="NODE_ENV" value="Production" /> </environmentVariables> </httpPlatform> </system.webServer> </configuration> - Create a subdirectory called "wiki" (i.e.
C:\MyStuff\wiki) - Create a file called
C:\MyStuff\wiki\tiddlywiki.infowith the content:{ "description": "My wiki", "plugins": [ "tiddlywiki/tiddlyweb", "tiddlywiki/filesystem" ], "themes": [ "tiddlywiki/vanilla", "tiddlywiki/snowwhite" ] } - Create a subdirectory called "tiddlers" (i.e.
C:\MyStuff\wiki\tiddlers) - Within it, create a file called
C:\MyStuff\wiki\tiddlers\config-tiddlyweb-host.tidwith the content:title: $:/config/tiddlyweb/host text: $protocol$//$host$/MyApp/- (See the documentation for details of the configuration fields for HttpPlatformHandler
- Execute the command
npm installwithin theC:/MyStuffdirectory
4. Setup the application in IIS
- In Windows, run the IIS Manager application (use the start menu to run
inetmgr.exe) - Locate the server in the Connections column on the left, and click the disclosure triangle to show its content
- Open the Sites folder
- Right click on the Default Web Site entry, and select Add application.. from the menu
- Enter the following information in the dialogue box:
- Alias:
MyApp - Physical path:
C:\MyStuff
- Alias:
- Click OK
5. Test the application
Test the app by visiting http://localhost/MyApp/ in a browser.
Notes
- If you require authentication, specify a username and password in the
--listencommand inweb.config. For example:arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki-server --listen username=joe "password=bloggs" port=PORT path-prefix=/MyApp">- Take note of the need to use double quotes around non-alphanumeric passwords, and to HTML encode them into
"
- If you change the settings in the
web.configfile, or modify the app code, then you'll need to restart the server using the IIS manager application
- Descarga e instala Node.js desde la página oficial: http://nodejs.org
- Abre una terminal de línea de comandos y teclea:
npm install -g tiddlywiki(ver nota * más abajo)Si te da fallo, necesitas volver a ejecutar la orden como administrador:
sudo npm install -g tiddlywiki(Mac/Linux) - Comprueba que TiddlyWiki se ha instalado con el comando:
tiddlywiki --version - Si todo está bien, TiddlyWiki devolverá el número de versión (p. ej, en este caso, 5.1.21. Puede que también muestre alguna información complementaria, de depuración.
- Probemos a ponerlo en marcha:
tiddlywiki miwiki --init servercreará, en el mismo directorio en el que hayas abierto la consola, una carpeta llamada miwiki, con los componentes necesarios.tiddlywiki miwiki --serverpondrá en marcha TiddlyWiki, que podrás ver y editar en el navegador.- Abre el navegador y escribe http://127.0.0.1:8080/ (o localhost:8080) en la barra de direcciones.
- Crea y edita tiddlers del modo acostumbrado. Los cambios se guardarán automáticamente en la carpeta miwiki/tiddlers
- Para apagar TiddlyWiki, cierra el navegador y haz Ctrl-C en la línea de comandos (o ciérrala: la consola te advertirá de que al hacerlo matarás el proceso en marcha. Confirma y listo)
- # Como opción, puedes hacer una copia offline del wiki:
- Con TiddlyWiki abierto en el navegador, haz click en el botón Guardar cambios de la barra lateral
- Con TiddlyWiki apagado y desde el mismo directorio desde donde lo iniciaste, teclea el siguiente comando en la consola:
tiddlywiki --build index
Nota: El argumento
-ghace que TiddlyWiki se instale globalmente (es decir, en todo el equipo). Sin él, TiddlyWiki estará disponible únicamente en el directorio desde el que lo instales.Si usas Debian o un sistema basado en Debian y recibes un mensaje del tipo
node: command not foundpese a haber instalado node.js, puede que necesites crear un enlace simbólico entrenodejsynode. En tal caso, consulta el manual de tu distribución de Linux ywhereis(más información sobre este comando) para crearlo correctamente (ver también issue 1434 en GitHub).Ejemplo en Debian v8.0:
sudo ln -s /usr/bin/nodejs /usr/bin/node
- Clone a local copy of the TiddlyWiki5 GitHub repository from https://github.com/Jermolene/TiddlyWiki5
- Open a command line terminal and change the current working directory to the root of the TiddlyWiki5 repo
- Type
npm link(Windows) orsudo npm link(Mac/Linux) to tell npm to use this copy of the repo as the globally installed one - Inside the root, you can launch TiddlyWiki like this:
tiddlywiki editions/tw5.com-server --listen
After this procedure you can work with TiddlyWiki5 via npm as though it had been installed in the usual way with npm install -g tiddlywiki.
Update the clone from time to time in order to ensure that you have the latest code.
Las instruciones de uso hablan directamente al lector –presumiblemente principiante o intermedio– y lo guían a través de determinado proceso.
Estos pueden subcategorizarse como:
- BIenvenida
- ¿Qué es TiddlyWiki y qué me importa?
- Demostraciones de características clave y sus beneficios para el usuario
- Preguntas de uso frecuente
- Ejemplos reales de uso de TiddlyWiki
- Información sobre el proyecto en sí
- Tutorial
- Presentación ordenada de material para novatos
- Cada tiddler presenta un tema o un concepto nuevo
- Su contenido principal contiene muy pocos enlaces
- Una sección de información complementaria "para saber más...." puede ofrecer enlaces relacionados al final del artículo
- Ejercicio
- Acompaña al tutorial
- Da la solución a pedido del usuario
- Guía paso-a-paso (How-to)
- Lista de pasos numerados para realizar pequeñas tareas específicas
- Concisa, con enlace a tiddlers de referencia cuando sea necesario y apropiado
- Suele abrirlo un preámbulo para aclarar la naturaleza y objetivos de la tarea
- Ejemplo
- Acompaña a tiddlers de referencia
- Puede contener explicaciones y comentarios similares
- Para que la información de referencia sea lo más aséptica posible, debe mantenerse separado de esta.
Las instrucciones de uso hablan al lector directamente y "de tú" y pueden ser razonablemente informales en su tono, pero debe evitarse el uso de coloquialismos, regionalismos, referencias culturales y humorísticas, ya que pueden desconcertar o incluso ofender a lectores internacionales.
Al hablar de características y procedimientos, hay que intentar no frustrar al lector abusando de expresiones como "conveniente" o "fácil".
Guía para arreglar un repositorio roto de Git, al estilo elige tu propia aventura
http://sukima.github.io/GitFixUm/
Este documento es un intento de hacer una guía bastante exhaustiva para recuperar un repositorio de Git de lo que no tenías intención de hacer.
No es que Git sea tan complicado que necesites todo un libro para resolver tu problema en particular, sino que el abanico de cosas que puedes haber hecho para armar lío es tan grande, que se necesitan varias técnicas para solucionarlo, dependiendo de qué hayas hecho y de qué querías hacer.
- Aquí se tratan los fundamentos de la creación de filtros para obtener una selección de tiddlers. Para una exposición más técnica del tema, véase Sintaxis de filtros.
El caso más simple es aquel en que ya conoces exactamente qué tiddlers quieres seleccionar. Escribe cada título en corchetes dobles, separados por por un espacio:
[[Libro de recetas]] [[HuevosRevueltos]] [[Tarta de manzana de mamá]]
Se pueden opitir los corchetes si el título no contiene espacios:
[[Libro de recetas]] HuevosRevueltos [[Tarta de manzana de mamá]]
Los corchetes dobles son, de hecho, la abreviatura de un filtro:
[title[HuevosRevueltos]]
... que nos sirve de modelo genera para cualquier filtro:
[operador[parámetro]]
Por ejemplo: Para seleccionar todos los tiddlers etiquetados como Receta:
operador
> [tag[Recetas]]
Podemos invertir el significado añadiendo un signo de exclamación ! al operador. Así, por ejemplo, para seleccionar aquellos tiddlers que no contengan la etiqueta Recetas, escribiremos:
[!tag[Recipe]]
Se pueden filtrar tiddlers por otros campos, no sólo por título y etiqueta:
[field:raciones[4]]
Con este ejemplo se seleccionarán todos aquellos tiddlers que tengan 4 como valor del campo raciones.
Como la palabra "raciones" no es operador estándar de filtro y es improbable que alguna vez lo sea, se puede omitir sin peligro alguno el prefijo field:
[raciones[4]]
Combinaciones
Los filtros vistos hasta ahora constan de un único paso, pero se se puede ejecutar una instrucción que consta de varios varios pasos, del modo siguiente:
[tag[Vegetariano]!tag[sopas]raciones[4]](Nótese cómo la instrucción entera queda encerrada por corchetes.
Un tiddler debe coincidir con todos los pasos de la instrucción. Así, el ejemplo anterior nos devolverá una lista de recetas vegetarianas –excepto sopas–, para 4 personas.
Una secuencia de instrucciones separadas seleccionará los tiddlers que coincidan con cualquiera de ellas. Puede servirnos para, por ejemplo, encontrar recetas para 3, 4 ó 5 personas, es decir, que cumplan cualquiera de las condiciones impuestas por estas: la primera, la segunda O la tercera.
[raciones[3]] [raciones[4]] [raciones[5]]
Y, si quisiéramos ignorar las recetas vegetarianas para 4 personas, podríamos decir:
[raciones[3]] [raciones[4]!tag[Vegetariano]] [serving[5]]
Por defecto, cada instrucción toma en consideración todos los tiddlers del wiki, pero podemos usar el signo + para restringir la acción de una instrucción a los tiddlers seleccionados por las precedentes, del modo que el resultado cumpla todas las condiciones: la anterior Y esta.
[raciones[3]] [raciones[4]] [raciones[5]] + [tag[Vegetariano]] +[sort[title]]
Asi seleccionaremos recetas para 3, 4 ó 5 personas y de entre estas, únicamente las vegetarianas, para, finalmente, ordenarlas por orden alfabético de sus títulos.
De forma análoga podemos usar el signo - para eliminar los tiddlers que cumplen determinada condición de los resultados obtenidos hasta el momento, de modo que se cumplan unas condiciones Y NO las otras.
Así podemos, por ejemplo, seleccionar todas las recetas vegetarianas salvo dos de ellas en particular:
[tag[Vegetariano]] -[title[HuevosRevueltos]] -RopaVieja
...o todas las recetas sin gluten, menos las vegetarianas:
[raciones[3]] [raciones[4]] [raciones[5]] + [tag[Sin gluten]] -[tag[Vegetariano]] +[sort[title]]
Parámetros especiales
Los parámetros de cada instrucción de filtrado vista hasta el momento se indica entre corchetes, significando con ello que TiddlyWiki debe interpretarlos literalmente, pero tenemos otras formas de indicar parámetros:
Entre llaves {}, para indicar que el parámetro es una referencia de texto y que debe buscar su valor en el texto de un tiddler en particular.
Por ejemplo: si tenemos un tiddler llamado Preferencias, cuyo texto es la palabra Vegetariano, podemos decir
[tag{Preferencias}]
como alternativa a [tag[Vegetariano]]. Esto permite que las preferencias cambien, sin necesidad de modificar el criterio de búsqueda.
Entre comillas angulares simples <>, para indicar que el parámetro es el nombre de una variable cuyo valor debe usar.
Aquí usaremos la variable incorporada currentTiddler en un filtro que selecciona todos los tiddlers cuyo texto contiene el título del actual:
[search<currentTiddler>]
Making lists of items plays a central role in working with TiddlyWiki. The following is a brief run-through of some of the more common techniques.
TiddlyWiki uses lists internally for many purposes so the word can have several meanings. Here we are concerned with displaying sequences of items, but not necessarily presented as a conventional bullet list.
Manually Typed Lists
WikiText
WikiText lists are manually typed lists that use a special character to specify what sort of list it is and how it should be displayed.
Examples include bullet lists created with asterisks (*) and numbered lists (#). Behind the scenes, WikiText lists are based on the standard <ul> and <li> HTML elements. For more information see Lists in WikiText.
An example of a typed list in WikiText:
* Greatest Movies of All Time
** Casa Blanca
** Pride and Prejudice and ZombiesEste es su aspecto:
- Greatest Movies of All Time
- Casa Blanca
- Pride and Prejudice and Zombies
Generated Lists
Lists can be automatically generated with the ListWidget using filters in which filter operators specify criteria for selecting which tiddlers are desired as output. Shortcut macros are provided for some common types of list.
ListWidget
The ListWidget is the most powerful tool for creating lists. It allows the filtered output to be manipulated and styled into forms that may not seem to resemble lists at all, for example tables or complex texts. For more details, see ListWidget.
An example to show all tiddlers tagged with "HelloThere" might look like:
<$list filter="[tag[HelloThere]]"><$view field="title"/><br/></$list>Este es su aspecto:
A Gentle Guide to TiddlyWiki
Discover TiddlyWiki
Some of the things you can do with TiddlyWiki
Ten reasons to switch to TiddlyWiki
Examples
What happened to the original TiddlyWiki?
Filtered transclusion
The syntax for filtered transclusion {{{...}}} takes a filter as input and outputs a linked list of matching titles. You can also apply a template, for example:
{{{ [tag[HelloThere]] || $:/core/ui/TagTemplate }}}Este es su aspecto:
list-links Macro
The list-links macro gives a preformatted list, typically a bullet list, in a more simplified way than by using the ListWidget. Behind the scenes it really is the ListWidget applying a default template to each list item.
<<list-links "[tag[HelloThere]]">>Este es su aspecto:
Other “list related” features
list, list-before and list-after are all field names to control the position of tiddlers in a list. Fields are a way to add additional bits of structured information to a tiddler such as date, quantity, category, etc.
list and listed are filter operators to, respectively, select and find titles in lists.
Esta breve presentación expone los principios básicos de TiddlyWiki.
El TiddlyWiki usado para este video se encuentra aquí:
| purpose | filter the input by fundamental category |
|---|---|
| input | a selection of titles |
| parameter | C = a category |
| output | those input tiddlers that belong to category C |
! output | those input tiddlers that do not belong to category C |
The parameter C is one of the following fundamental categories:
| Category | Matches any tiddler title that... |
|---|---|
current | is the current tiddler |
image | has an image ContentType |
missing | does not exist (other than possibly as a shadow tiddler), regardless of whether there are any links to it |
orphan | has no hard links to it |
shadow | is a shadow tiddler, regardless of whether it has been overridden with a non-shadow tiddler |
system | is a system tiddler, i.e. its title starts with $:/ |
tag | is in use as a tag |
tiddler | exists as a non-shadow tiddler |
variable | New in: 5.1.20 exists as a variable (whether or not that variable has a non-blank value) |
blank | New in: 5.1.20 is blank (i.e. is a zero length string) |
If C is anything else an error message is returned. New in: 5.1.14 if C is blank, the output is passed through unchanged (in earlier versions an error message was returned).
!is[tiddler] is a synonym for is[missing], and vice versa.
When is[missing] is the first operator in a run, its output is always empty. And when is[shadow] comes first, it outputs only those shadow tiddlers that have been overridden. This is because the initial input to a run contains only non-shadow tiddlers.
The all operator is similar, but its scope is the whole wiki.
[is[tag]]
[!is[tag]]
[all[shadows]!is[system]]
$:/[is[system]tag[$:/tags/Stylesheet]]
[all[shadows]is[system]tag[$:/tags/Stylesheet]]
[is[shadow]]
[is[missing]]
JavaScript es un lenguaje de programación originariamente para incluir pequeños scripts en páginas web. Por ese motivo se lo consideraba más un juguete que un lenguaje en sí. Con los años, sin embargo, se ha reconocido su potencial y se ha ganado por propio derecho un lugar en la programación más allá de los límites del propio navegador y la web.
JavaScript tiene este aspecto:
function circleArea(radius) {
return radius * 2 * 3.141592653;
}JSON is a standard plain-text format used for modelling hierarchical structures of objects that contain named fields.
DataTiddlers can have JSON content.
The jsontiddlers macro returns tiddler content in JSON format.
I'm the original inventor of TiddlyWiki. You can hire me through Federatial, and find me on these services:
- jeremy (at) jermolene (dot) com
- Jermolene on GitHub
- Jermolene on GitTip, a micropayment service
- @Jermolene on Twitter
- Jermy on LinkedIn
- Jermy on Flickr
Further information:
- An interview with me in The Inquirer by Wendy Grossman
- A hilarious interview with me from British television in 1983
- Here's a video of a presentation I did in 2007 called "How to Start an Open Source Project".
| purpose | join a list of strings together with the separator S |
|---|---|
| input | a selection of titles |
| parameter | S = the separator to insert between each of the items |
| output | the input titles joined together with the separator S |
New in: 5.1.20
Extend tiddlywiki to parse complex ("nested") json data tiddlers.
Json Mangler introduces a new path syntax for indexes of json data tiddlers , and includes many supporting tools, filters, widgets, etc.
Example Wiki: https://joshuafontany.github.io/TW5-JsonManglerPlugin/
Source: https://github.com/joshuafontany/TW5-JsonManglerPlugin
| purpose | apply JSON string encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with JSON string encodings applied |
The following substitutions are made:
| Character | Replacement |
|---|---|
\ | \\ |
" | \\ |
' | \\ |
\r (carriage return) | \\r |
\n (line feed) | \\n |
| Characters from 0x00 to 0x1f | \\x## where ## is two hex digits |
| Characters from 0x80 to 0xffff | \\u#### where #### is four hex digits |
Also see the stringify Operator.
[[Title with "double quotes" and single ' and \backslash]] +[jsonstringify[]]
A JSON tiddler is a data tiddler containing a JSON structure in its text field.
Its ContentType is application/json.
The history list is a good example of a JSON tiddler.
The jsontiddlers macro returns the fields of a selection of tiddlers in JSON form.
An example can be seen in the template tiddler for JSON exports.
Parameters
- filter
- A filter selecting which tiddlers to include
Este plugin permite mostrar notación matemática escrita en LaTeX.
Disponible en: https://tiddlywiki.com/plugins/tiddlywiki/katex/
Keyboard Shortcut Descriptors are used by the KeyboardWidget and within Tiddlers tagged to link actions with a keyboard combination
A Keyboard Shortcut Descriptor has the following format:
ctrl+enter
ctrl+shift+alt+A
alt-shift-T
alt-SpaceIt can have multiple Key combinations:
ctrl+enter alt+shift+A ctrl+alt+9 alt-Space ctrl-BackspaceThere are two ways Keyboard Shortcut Descriptors can be used:
- directly
- passing the attribute
key="ctrl-enter"to the KeyboardWidget - setting
ctrl-enteras the value of thekeyfield in a Tiddler tagged
- passing the attribute
- with a reference to a configuration Tiddler
- A configuration Tiddler for Keyboard Shortcuts follows some naming rules:
- The title starts with
$:/config/ - Followed by either the string
shortcutsor one of the following platform descriptors:shortcuts-linuxshortcuts-not-linuxshortcuts-macshortcuts-not-macshortcuts-windowsshortcuts-not-windows
- The title ends with another
/followed by a suffix that can be chosen freely- This suffix is the identifier for the
Keyboard Shortcut Descriptor(A)
- This suffix is the identifier for the
- The title starts with
- The reference to the configuration Tiddler is made of
((+ the identifier (A) +))- Example:
((my-shortcut))is the reference to these configuration Tiddlers:
- Example:
- Finally, the referenced configuration Tiddler stores the Keyboard Shortcut Descriptor in its text field
- A configuration Tiddler for Keyboard Shortcuts follows some naming rules:
A Keyboard Shortcut Tiddler is made of three parts:
- The Tag
- The field
keywith a Keyboard Shortcut Descriptor as its value - Actions in its text field
If the Keyboard Shortcut Descriptor has the form ((my-shortcut)) it's a reference to a configuration Tiddler that stores the corresponding Keyboard Shortcut
In order to make a shortcut editable through the Atajos de teclado Tab in the $:/ControlPanel it's sufficient to create a tiddler $:/config/ShortcutInfo/my-shortcut, where the suffix is the reference used for the Keyboard Shortcut
TiddlyWiki ofrece actualmente un muy limitado soporte de atajos de teclado, pero está en proyecto desarrollarlo en próximas ediciones.
Atajos de edición
| Teclas | Descripción |
| ctrl-enter | Confirmar los cambios realizados en el borrador en foco |
| escape | Descartar los cambios realizados y abandonar la edición del borrador en foco |
Introduction
The keyboard widget allows ActionWidgets to be triggered by specific key combinations. There is also a shorthand for generating Messages via the message and param attributes.
Content and Attributes
The content of the <$keyboard> widget is rendered normally. The keyboard shortcuts only take effect when the focus is within the contained content.
| Attribute | Description |
|---|---|
| actions | A string containing ActionWidgets to be triggered when the key combination is detected |
| message | The title of the WidgetMessage to generate |
| param | The parameter to be passed with the WidgetMessage |
| key | Key string identifying the key(s) to be trapped (see below) |
| class | A CSS class to be assigned to the generated HTML DIV element |
| tag | New in: 5.1.14 The html element the widget creates to capture the keyboard event, defaults to: » span when parsed in inline-mode» div when parsed in block-mode |
Key Strings
Key strings are made up of one or more key specifiers separated by spaces. Each key specifier is zero or more of the modifiers alt, shift, ctrl or meta followed by the name of a key, all joined with "+" plus or "-" minus symbols. Key names are either the letter or digit printed on the key (eg "a" or "1"), or one of the special keys backspace, tab, enter or escape.
For example:
A
shift+A
shift+escape
ctrl+enter
ctrl+shift+alt+AThe purpose of the kin operator with examples:
- Finds related tags, related tiddlers in any depth
- Finds out where base tiddler originates and what other elements originate from it
- Finds the ancestors and successors of a family member
- Finds the "leaves" of the branch of the base tiddler in a tree-like structure (where the base tiddler is a leaf)
- Finds the super- and subsets / groups of a mathematical set (where the base tiddler is a set)
티들리위키 한국어 번역은 다음에서 사용할 수 있습니다:
Here is an example of using the ListWidget and the TranscludeWidget to show a grid of all of Language Icons which are tiddlers tagged and
%22%2F%3E%0A%3Cg%20id%3D%22plus_ultra%22%20fill%3D%22%23c8b100%22%20stroke%3D%22none%22%3E%0A%3Cpath%20d%3D%22m166.42%20264.65c1.99-0.72%203.29-1.58%202.66-3.14-0.41-1-1.43-1.19-2.97-0.63l-2.71%200.99%202.44%206.03c0.27-0.12%200.54-0.24%200.81-0.34%200.28-0.1%200.57-0.18%200.85-0.26l-1.08-2.64v-0.01zm-1.18-2.91l0.69-0.25c0.57-0.21%201.21%200.1%201.5%200.8%200.21%200.53%200.16%201.13-0.5%201.55-0.21%200.13-0.46%200.23-0.7%200.33l-0.99-2.43%22%2F%3E%0A%3Cpath%20d%3D%22m172.78%20259.22c-0.29%200.08-0.57%200.16-0.86%200.22-0.29%200.05-0.59%200.09-0.88%200.12l1.41%206.28%204.38-0.88c-0.05-0.12-0.12-0.26-0.14-0.38-0.03-0.14-0.03-0.28-0.04-0.41-0.77%200.22-1.61%200.46-2.61%200.66l-1.26-5.61%22%2F%3E%0A%3Cpath%20d%3D%22m181.56%20264.63c0.82-2.28%201.82-4.46%202.81-6.67-0.18%200.03-0.36%200.06-0.54%200.07s-0.37%200.01-0.54%200c-0.53%201.61-1.18%203.21-1.87%204.8-0.82-1.51-1.73-2.99-2.43-4.51-0.34%200.04-0.69%200.09-1.03%200.12-0.34%200.02-0.7%200.01-1.04%200.02%201.26%202.06%202.48%204.11%203.64%206.23%200.16-0.03%200.32-0.06%200.5-0.08%200.16-0.01%200.33%200.01%200.5%200.02%22%2F%3E%0A%3Cpath%20d%3D%22m190.72%20259.8c0.15-0.31%200.31-0.6%200.48-0.89-0.24-0.22-0.96-0.55-1.81-0.63-1.79-0.18-2.81%200.61-2.93%201.69-0.26%202.26%203.31%202.07%203.14%203.57-0.07%200.64-0.75%200.9-1.48%200.83-0.81-0.08-1.41-0.53-1.51-1.19l-0.22-0.02c-0.12%200.39-0.29%200.77-0.48%201.15%200.53%200.34%201.21%200.53%201.85%200.59%201.83%200.19%203.22-0.54%203.35-1.74%200.23-2.15-3.37-2.27-3.23-3.54%200.06-0.53%200.47-0.88%201.4-0.79%200.67%200.07%201.08%200.43%201.26%200.95l0.18%200.02%22%2F%3E%0A%3Cpath%20d%3D%22m310.3%20264.98c0.62-2.33%201.41-4.58%202.19-6.87-0.17%200.05-0.35%200.09-0.53%200.11-0.17%200.03-0.36%200.04-0.54%200.05-0.37%201.64-0.88%203.29-1.42%204.94-0.96-1.44-2-2.84-2.83-4.3-0.34%200.07-0.68%200.15-1.02%200.2s-0.69%200.07-1.04%200.11c1.45%201.94%202.85%203.89%204.2%205.91%200.16-0.04%200.32-0.1%200.5-0.12%200.16-0.02%200.33-0.02%200.49-0.03%22%2F%3E%0A%3Cpath%20d%3D%22m316.48%20258.16c-0.29%200.01-0.59%200.04-0.88%200.03-0.3%200-0.6-0.04-0.89-0.06l-0.12%206.41%204.49%200.08c-0.03-0.13-0.06-0.28-0.06-0.41s0.04-0.27%200.07-0.4c-0.81%200.05-1.68%200.1-2.71%200.08l0.1-5.73%22%2F%3E%0A%3Cpath%20d%3D%22m323.52%20259.21c0.72%200.06%201.41%200.19%202.1%200.31-0.01-0.13-0.03-0.27-0.02-0.41%200.01-0.13%200.06-0.26%200.1-0.39l-6.07-0.5c0.01%200.14%200.03%200.27%200.02%200.4-0.01%200.14-0.06%200.27-0.1%200.4%200.62-0.02%201.37-0.02%202.21%200.05l-0.53%205.77c0.29%200%200.59%200%200.88%200.03%200.3%200.02%200.59%200.07%200.88%200.11l0.53-5.77%22%2F%3E%0A%3Cpath%20d%3D%22m326.01%20265.53c0.29%200.05%200.59%200.09%200.88%200.15%200.28%200.06%200.57%200.15%200.85%200.23l0.72-2.94%200.08%200.01c0.16%200.41%200.38%200.9%200.49%201.19l0.9%202.22c0.36%200.06%200.71%200.11%201.05%200.18%200.36%200.08%200.7%200.18%201.04%200.28l-0.31-0.67c-0.48-1-0.99-2.01-1.41-3.02%201.12%200.04%201.98-0.36%202.2-1.26%200.15-0.62-0.1-1.11-0.68-1.53-0.44-0.31-1.28-0.47-1.83-0.6l-2.44-0.53-1.54%206.29m3.14-5.42c0.71%200.16%201.59%200.27%201.59%201.07-0.01%200.21-0.03%200.35-0.06%200.48-0.23%200.94-0.94%201.26-2.13%200.91l0.6-2.46%22%2F%3E%0A%3Cpath%20d%3D%22m337.57%20267.46c-0.05%200.69-0.18%201.37-0.31%202.1%200.3%200.14%200.61%200.27%200.9%200.44%200.3%200.16%200.57%200.34%200.86%200.52l0.6-7.23c-0.14-0.06-0.27-0.12-0.41-0.19-0.13-0.07-0.25-0.15-0.37-0.24l-6.38%204.05c0.17%200.08%200.35%200.16%200.51%200.25%200.17%200.09%200.31%200.19%200.47%200.28%200.54-0.45%201.1-0.82%201.74-1.3l2.39%201.31v0.01zm-1.81-1.66l2.13-1.37-0.25%202.4-1.88-1.03%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22crown_crest%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20stroke-width%3D%220.26%22%20d%3D%22m249.65%20182.72c6.64%200%2012.56%200.99%2016.41%202.51%202.2%201%205.16%201.73%208.4%202.17%202.47%200.33%204.81%200.39%206.85%200.24%202.73-0.06%206.67%200.74%2010.62%202.48%203.26%201.45%205.99%203.21%207.8%204.91l-1.57%201.4-0.45%203.96-4.3%204.92-2.15%201.83-5.09%204.07-2.6%200.21-0.79%202.25-32.91-3.86-33.02%203.86-0.79-2.25-2.61-0.21-5.08-4.07-2.15-1.83-4.3-4.92-0.44-3.96-1.58-1.4c1.82-1.7%204.54-3.46%207.8-4.91%203.95-1.74%207.89-2.54%2010.62-2.48%202.04%200.15%204.38%200.09%206.85-0.24%203.24-0.44%206.2-1.17%208.4-2.17%203.86-1.52%209.44-2.51%2016.08-2.51z%22%2F%3E%0A%3Cg%20fill%3D%22%23c8b100%22%3E%0A%3Cpath%20d%3D%22m225.34%20191.42l1.38%201.11%202.08-3.4c-2.25-1.38-3.8-3.78-3.8-6.51%200-0.31%200.02-0.61%200.06-0.91%200.21-4.34%205.5-7.92%2012.2-7.92%203.48%200%206.63%200.95%208.84%202.48%200.06-0.67%200.12-1.25%200.21-1.86-2.43-1.42-5.6-2.28-9.05-2.28-7.71%200-13.74%204.39-14.03%209.57-0.03%200.31-0.05%200.61-0.05%200.92%200%202.76%201.26%205.26%203.26%206.99l-1.1%201.81%22%2F%3E%0A%3Cpath%20d%3D%22m225.43%20191.46c-2.63-1.97-4.27-4.64-4.27-7.58%200-3.38%202.22-6.4%205.58-8.41-2.07%201.67-3.33%203.83-3.51%206.23-0.03%200.31-0.05%200.61-0.05%200.92%200%202.76%201.26%205.26%203.26%206.99l-1.01%201.85%22%2F%3E%0A%3Cpath%20d%3D%22m202.21%20194.89c-1.48-1.65-2.38-3.79-2.38-6.12%200-1.41%200.33-2.75%200.91-3.95%202.13-4.38%208.82-7.57%2016.76-7.57%202.16%200%204.23%200.23%206.14%200.67-0.42%200.46-0.75%200.97-1.08%201.48-1.59-0.31-3.29-0.48-5.06-0.48-7.27%200-13.36%202.83-15.12%206.65-0.47%200.97-0.73%202.06-0.73%203.2%200%202.32%201.09%204.4%202.79%205.82l-2.63%204.3-1.41-1.12%201.81-2.88z%22%2F%3E%0A%3Cpath%20d%3D%22m204.9%20180.48c-1.91%201.21-3.36%202.69-4.16%204.34-0.58%201.2-0.91%202.54-0.91%203.95%200%202.33%200.9%204.47%202.38%206.12l-1.6%202.59c-1.53-1.96-2.42-4.26-2.42-6.7%200-4.2%202.67-7.87%206.71-10.3z%22%2F%3E%0A%3Cpath%20d%3D%22m250.04%20171.27c1.76%200%203.28%201.16%203.64%202.73%200.23%201.38%200.38%202.95%200.41%204.62%200.01%200.18-0.01%200.35-0.01%200.52%200%200.2%200.04%200.41%200.05%200.61%200.06%203.52%200.56%206.62%201.27%208.52l-5.36%205.14-5.43-5.14c0.72-1.9%201.22-5%201.29-8.52%200-0.2%200.04-0.41%200.04-0.61%200-0.17-0.01-0.34-0.01-0.52%200.03-1.67%200.18-3.24%200.41-4.62%200.36-1.57%201.94-2.73%203.7-2.73z%22%2F%3E%0A%3Cpath%20d%3D%22m250.04%20172.94c0.91%200%201.68%200.58%201.87%201.39%200.23%201.31%200.37%202.8%200.4%204.38%200%200.16-0.01%200.32-0.01%200.48%200%200.2%200.03%200.39%200.04%200.59%200.05%203.32%200.53%206.25%201.21%208.05l-3.54%203.35-3.54-3.35c0.67-1.8%201.15-4.73%201.21-8.05%200-0.2%200.04-0.39%200.04-0.59%200-0.16-0.01-0.32-0.01-0.48%200.03-1.58%200.17-3.07%200.4-4.38%200.18-0.81%201.02-1.39%201.93-1.39z%22%2F%3E%0A%3Cpath%20d%3D%22m274.7%20191.42l-1.39%201.11-2.08-3.4c2.26-1.38%203.81-3.78%203.81-6.51%200-0.31-0.02-0.61-0.06-0.91-0.21-4.34-5.5-7.92-12.2-7.92-3.49%200-6.63%200.95-8.84%202.48-0.06-0.67-0.12-1.25-0.22-1.86%202.44-1.42%205.6-2.28%209.06-2.28%207.71%200%2013.74%204.39%2014.03%209.57%200.03%200.31%200.05%200.61%200.05%200.92%200%202.76-1.27%205.26-3.27%206.99l1.11%201.81%22%2F%3E%0A%3Cpath%20d%3D%22m274.61%20191.46c2.63-1.97%204.27-4.64%204.27-7.58%200-3.38-2.22-6.4-5.58-8.41%202.07%201.67%203.33%203.83%203.51%206.23%200.03%200.31%200.05%200.61%200.05%200.92%200%202.76-1.27%205.26-3.27%206.99l1.02%201.85%22%2F%3E%0A%3Cpath%20d%3D%22m297.83%20194.89c1.47-1.65%202.38-3.79%202.38-6.12%200-1.41-0.33-2.75-0.91-3.95-2.14-4.38-8.82-7.57-16.76-7.57-2.16%200-4.23%200.23-6.15%200.67%200.43%200.46%200.76%200.97%201.09%201.48%201.58-0.31%203.29-0.48%205.06-0.48%207.27%200%2013.35%202.83%2015.11%206.65%200.47%200.97%200.73%202.06%200.73%203.2%200%202.32-1.09%204.4-2.79%205.82l2.63%204.3%201.42-1.12-1.81-2.88z%22%2F%3E%0A%3Cpath%20d%3D%22m295.14%20180.48c1.91%201.21%203.36%202.69%204.16%204.34%200.58%201.2%200.91%202.54%200.91%203.95%200%202.33-0.91%204.47-2.38%206.12l1.6%202.59c1.53-1.96%202.41-4.26%202.41-6.7%200-4.2-2.67-7.87-6.7-10.3z%22%2F%3E%0A%3Cellipse%20fill%3D%22%23005bbf%22%20stroke-width%3D%220.26%22%20cx%3D%22250.05%22%20cy%3D%22167.3%22%20rx%3D%224.43%22%20ry%3D%224.2%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.26%22%20d%3D%22m248.89%20155.54v2.26h-2.42v2.3h2.42v3.15%203.46h-3.05c-0.03%200.21-0.22%200.37-0.22%200.59%200%200.58%200.12%201.14%200.35%201.64%200%200.02%200.02%200.02%200.03%200.03h8.12c0-0.01%200.02-0.01%200.03-0.03%200.22-0.5%200.35-1.06%200.35-1.64%200-0.22-0.19-0.38-0.22-0.59h-2.96v-3.43-3.18h2.42v-2.3h-2.42v-2.26h-2.43z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22%23fff%22%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22188.94%22%20rx%3D%221.91%22%20ry%3D%221.8%22%2F%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22185.4%22%20rx%3D%221.91%22%20ry%3D%221.8%22%2F%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22181.6%22%20rx%3D%221.52%22%20ry%3D%221.44%22%2F%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22178.18%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22175.18%22%20rx%3D%220.88%22%20ry%3D%220.83%22%2F%3E%0A%3Cellipse%20cx%3D%22198.94%22%20cy%3D%22198.67%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22197.44%22%20cy%3D%22196.02%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22196.44%22%20cy%3D%22192.94%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22196.31%22%20cy%3D%22189.64%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22197.12%22%20cy%3D%22186.4%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22198.81%22%20cy%3D%22183.45%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22201.06%22%20cy%3D%22181.02%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22203.68%22%20cy%3D%22179.01%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22206.8%22%20cy%3D%22177.36%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22210.04%22%20cy%3D%22176.19%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22213.66%22%20cy%3D%22175.54%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22217.1%22%20cy%3D%22175.36%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22220.47%22%20cy%3D%22175.48%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22224.21%22%20cy%3D%22190.32%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22222.34%22%20cy%3D%22187.65%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22221.35%22%20cy%3D%22184.75%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22221.47%22%20cy%3D%22181.57%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22222.16%22%20cy%3D%22178.37%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22223.84%22%20cy%3D%22175.48%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22226.4%22%20cy%3D%22173.47%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22229.39%22%20cy%3D%22171.81%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22232.7%22%20cy%3D%22170.82%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22236.13%22%20cy%3D%22170.23%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22239.5%22%20cy%3D%22170.28%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22242.99%22%20cy%3D%22170.87%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22246.23%22%20cy%3D%22171.99%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22253.8%22%20cy%3D%22171.99%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22257.04%22%20cy%3D%22170.87%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22260.54%22%20cy%3D%22170.28%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22263.9%22%20cy%3D%22170.23%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22267.34%22%20cy%3D%22170.82%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22270.64%22%20cy%3D%22171.81%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22273.64%22%20cy%3D%22173.47%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22276.19%22%20cy%3D%22175.48%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22277.88%22%20cy%3D%22178.37%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22278.57%22%20cy%3D%22181.57%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22278.69%22%20cy%3D%22184.75%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22277.69%22%20cy%3D%22187.65%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22275.83%22%20cy%3D%22190.32%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22279.57%22%20cy%3D%22175.48%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22282.94%22%20cy%3D%22175.36%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22286.38%22%20cy%3D%22175.54%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22290%22%20cy%3D%22176.19%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22293.24%22%20cy%3D%22177.36%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22296.36%22%20cy%3D%22179.01%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22298.97%22%20cy%3D%22181.02%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22301.22%22%20cy%3D%22183.45%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22302.91%22%20cy%3D%22186.4%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22303.72%22%20cy%3D%22189.64%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22303.6%22%20cy%3D%22192.94%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22302.6%22%20cy%3D%22196.02%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22301.1%22%20cy%3D%22198.67%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22%23c8b100%22%3E%0A%3Cpath%20d%3D%22m250.15%20226.18c-12.26-0.02-23.25-1.47-31.09-3.83-0.57-0.18-0.87-0.7-0.84-1.25-0.01-0.52%200.29-1%200.84-1.17%207.84-2.36%2018.83-3.81%2031.09-3.83%2012.27%200.02%2023.25%201.47%2031.09%203.83%200.55%200.17%200.84%200.65%200.83%201.17%200.03%200.55-0.27%201.07-0.83%201.25-7.84%202.36-18.82%203.81-31.09%203.83%22%2F%3E%0A%3Cpath%20d%3D%22m250.07%20216.09c-12.41%200.03-23.55%201.58-31.39%204%200.65-0.31%200.59-1.12-0.22-3.2-0.98-2.53-2.5-2.42-2.5-2.42%208.66-2.56%2020.73-4.16%2034.16-4.18%2013.44%200.02%2025.6%201.62%2034.27%204.18%200%200-1.53-0.11-2.51%202.42-0.81%202.08-0.87%202.89-0.21%203.2-7.84-2.42-19.19-3.97-31.6-4%22%2F%3E%0A%3Cpath%20d%3D%22m250.12%20210.3c-13.43%200.02-25.5%201.62-34.16%204.18-0.58%200.17-1.19-0.05-1.38-0.6s0.12-1.18%200.7-1.35c8.71-2.67%2021.08-4.35%2034.84-4.38%2013.77%200.03%2026.19%201.71%2034.9%204.38%200.58%200.17%200.89%200.8%200.7%201.35s-0.8%200.77-1.38%200.6c-8.67-2.56-20.78-4.16-34.22-4.18%22%2F%3E%0A%3Cpath%20d%3D%22m250.2%20199.78l1.23%200.22c-0.19%200.5-0.24%201.05-0.24%201.63%200%202.57%202.21%204.65%204.92%204.65%202.18%200%204.04-1.35%204.67-3.21%200.08%200.05%200.47-1.68%200.68-1.66%200.17%200.02%200.15%201.8%200.22%201.77%200.31%202.34%202.46%203.93%204.87%203.93%202.71%200%204.91-2.08%204.91-4.65%200-0.19-0.01-0.38-0.04-0.57l1.54-1.52%200.83%201.94c-0.33%200.61-0.46%201.3-0.46%202.03%200%202.46%202.1%204.44%204.69%204.44%201.63%200%203.06-0.78%203.9-1.97l0.99-1.25-0.01%201.53c0%201.55%200.66%202.93%202.16%203.18%200%200%201.73%200.1%204.03-1.7%202.29-1.8%203.55-3.29%203.55-3.29l0.2%201.8s-1.9%202.95-3.97%204.15c-1.14%200.66-2.86%201.35-4.23%201.13-1.44-0.24-2.48-1.4-3.01-2.74-1.03%200.61-2.25%200.97-3.55%200.97-2.81%200-5.33-1.54-6.32-3.86-1.29%201.4-3.09%202.25-5.2%202.25-2.24%200-4.29-1.01-5.57-2.56-1.27%201.16-2.98%201.87-4.88%201.87-2.48%200-4.69-1.22-5.94-3.05-1.25%201.83-3.46%203.05-5.94%203.05-1.89%200-3.61-0.71-4.87-1.87-1.28%201.55-3.34%202.56-5.58%202.56-2.11%200-3.9-0.85-5.19-2.25-1%202.32-3.52%203.86-6.32%203.86-1.31%200-2.52-0.36-3.55-0.97-0.54%201.34-1.57%202.5-3.02%202.74-1.36%200.22-3.08-0.47-4.22-1.13-2.08-1.2-3.98-4.15-3.98-4.15l0.2-1.8s1.27%201.49%203.56%203.29c2.29%201.81%204.02%201.7%204.02%201.7%201.51-0.25%202.16-1.63%202.16-3.18l-0.01-1.53%200.99%201.25c0.84%201.19%202.28%201.97%203.9%201.97%202.59%200%204.69-1.98%204.69-4.44%200-0.73-0.13-1.42-0.46-2.03l0.83-1.94%201.54%201.52c-0.02%200.19-0.04%200.38-0.04%200.57%200%202.57%202.2%204.65%204.91%204.65%202.42%200%204.56-1.59%204.88-3.93%200.06%200.03%200.05-1.75%200.22-1.77%200.2-0.02%200.6%201.71%200.67%201.66%200.64%201.86%202.49%203.21%204.68%203.21%202.71%200%204.91-2.08%204.91-4.65%200-0.58-0.03-1.13-0.24-1.63l1.29-0.22%22%2F%3E%0A%3Cpath%20d%3D%22m208.37%20206.32c-0.11-0.37-0.35-0.75-0.72-1.06-0.79-0.68-1.84-0.79-2.36-0.25-0.07%200.07-0.13%200.17-0.17%200.25%200%200-1.11-2.08-2.41-2.78-1.29-0.7-3.49-0.52-3.49-0.52%200-1.6%201.3-2.89%202.99-2.89%200.99%200%201.92%200.41%202.48%201.11l0.23-1.07s1.36%200.27%201.98%201.82-0.06%203.8-0.06%203.8%200.34-0.96%200.85-1.61c0.51-0.64%201.81-1.34%202.49-1.66%200.67-0.31%201.37-0.79%201.37-0.79s0.03%200.18%200.05%200.61c0.03%200.51-0.01%200.83-0.01%200.83%201.24-0.17%202.69%200.04%203.83%200.48-0.49%200.95-1.41%201.84-2.62%202.3%200%200%200.44%200.36%200.83%200.75%200.34%200.34%200.44%200.49%200.44%200.49s-0.85%200.13-1.27%200.19c-0.43%200.05-1.84%200.28-2.69%200.22-0.62-0.04-1.32-0.14-1.74-0.22%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m205.29%20205.01c0.52-0.54%201.57-0.43%202.36%200.25%200.8%200.67%201.02%201.66%200.51%202.19-0.51%200.54-1.57%200.42-2.36-0.25-0.79-0.68-1.02-1.66-0.51-2.19%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m216.39%20205.91c-0.28-0.83-0.03-1.65%200.57-1.83%200.6-0.19%201.32%200.33%201.6%201.16s0.03%201.65-0.57%201.84c-0.6%200.18-1.31-0.34-1.6-1.17%22%2F%3E%0A%3Cpath%20d%3D%22m226.12%20201.86c-0.33-0.27-0.59-0.64-0.67-1.08s0.01-0.87%200.23-1.23c0%200-0.88-0.44-1.83-0.69-0.72-0.19-1.99-0.2-2.37-0.2-0.38-0.02-1.15-0.03-1.15-0.03s0.07%200.17%200.28%200.55c0.27%200.46%200.5%200.75%200.5%200.75-1.27%200.29-2.35%201.12-3.03%202.09%200.99%200.68%202.3%201.1%203.6%200.97%200%200-0.12%200.34-0.2%200.86-0.06%200.43-0.06%200.61-0.06%200.61s0.71-0.26%201.07-0.39c0.35-0.13%201.54-0.55%202.15-0.96%200.8-0.54%201.48-1.25%201.48-1.25%22%2F%3E%0A%3Cpath%20d%3D%22m225.68%20191.65c1.06%200.67%201.98%201.79%202.3%203.03%200%200%200.13-0.25%200.71-0.59%200.59-0.33%201.09-0.32%201.09-0.32s-0.17%200.97-0.25%201.32c-0.09%200.34-0.09%201.38-0.32%202.32-0.23%200.93-0.63%201.68-0.63%201.68-0.42-0.34-0.99-0.51-1.58-0.41-0.58%200.1-1.06%200.44-1.32%200.9%200%200-0.66-0.58-1.21-1.38-0.55-0.81-0.93-1.78-1.13-2.08-0.21-0.3-0.72-1.15-0.72-1.15s0.47-0.18%201.14-0.05c0.67%200.12%200.88%200.32%200.88%200.32-0.14-1.28%200.28-2.62%201.04-3.59%22%2F%3E%0A%3Cpath%20d%3D%22m228.97%20201.38c0.22-0.35%200.32-0.79%200.24-1.23s-0.32-0.81-0.66-1.07c0%200%200.67-0.71%201.47-1.26%200.6-0.41%201.8-0.82%202.15-0.95%200.36-0.13%201.07-0.4%201.07-0.4s0%200.18-0.06%200.61c-0.08%200.52-0.2%200.87-0.2%200.87%201.3-0.14%202.62%200.29%203.61%200.98-0.69%200.97-1.77%201.79-3.04%202.08%200%200%200.23%200.28%200.5%200.74%200.21%200.39%200.28%200.56%200.28%200.56s-0.77-0.02-1.15-0.03c-0.38%200-1.65-0.01-2.37-0.2-0.95-0.25-1.84-0.69-1.84-0.69%22%2F%3E%0A%3Cellipse%20fill%3D%22%23ad1519%22%20cx%3D%22227.37%22%20cy%3D%22200.45%22%20rx%3D%222.17%22%20ry%3D%222.06%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m237.76%20201.77c-0.11-0.87%200.31-1.63%200.93-1.7%200.63-0.07%201.23%200.57%201.34%201.44%200.11%200.86-0.3%201.63-0.93%201.7-0.62%200.07-1.22-0.57-1.34-1.44%22%2F%3E%0A%3Cpath%20d%3D%22m248.5%20199.83c-0.32-0.36-0.53-0.82-0.53-1.33%200-0.5%200.19-0.97%200.51-1.32%200%200-0.89-0.67-1.89-1.12-0.77-0.35-2.18-0.59-2.6-0.67-0.43-0.08-1.28-0.24-1.28-0.24s0.04%200.2%200.2%200.67c0.2%200.56%200.4%200.93%200.4%200.93-1.47%200.08-2.85%200.81-3.81%201.76%200.96%200.94%202.34%201.66%203.81%201.75%200%200-0.2%200.36-0.4%200.93-0.16%200.46-0.2%200.67-0.2%200.67s0.85-0.16%201.28-0.24c0.42-0.08%201.83-0.32%202.6-0.67%201-0.46%201.91-1.11%201.91-1.11%22%2F%3E%0A%3Cpath%20d%3D%22m250.11%20188.36c1.05%200.95%201.85%202.36%201.95%203.82%200%200%200.19-0.27%200.91-0.53%200.73-0.26%201.28-0.16%201.28-0.16s-0.39%201.05-0.55%201.42c-0.17%200.37-0.39%201.53-0.84%202.53-0.44%201-1.05%201.76-1.05%201.76-0.4-0.45-1-0.75-1.67-0.75-0.68%200-1.27%200.3-1.67%200.75%200%200-0.61-0.76-1.05-1.76-0.45-1-0.67-2.16-0.84-2.53s-0.56-1.42-0.56-1.42%200.56-0.1%201.28%200.16%200.92%200.53%200.92%200.53c0.1-1.46%200.86-2.87%201.89-3.82%22%2F%3E%0A%3Cpath%20d%3D%22m251.76%20199.83c0.33-0.36%200.53-0.82%200.53-1.33%200-0.5-0.19-0.97-0.51-1.32%200%200%200.89-0.67%201.9-1.12%200.76-0.35%202.17-0.59%202.6-0.67%200.42-0.08%201.26-0.24%201.26-0.24s-0.02%200.2-0.19%200.67c-0.2%200.56-0.4%200.93-0.4%200.93%201.47%200.08%202.86%200.81%203.81%201.76-0.95%200.94-2.33%201.66-3.81%201.75%200%200%200.2%200.36%200.4%200.93%200.16%200.46%200.19%200.67%200.19%200.67l-1.26-0.24c-0.43-0.08-1.84-0.32-2.6-0.67-1.01-0.46-1.92-1.11-1.92-1.11%22%2F%3E%0A%3Cellipse%20fill%3D%22%23ad1519%22%20cx%3D%22250.14%22%20cy%3D%22198.5%22%20rx%3D%222.17%22%20ry%3D%222.06%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m262.58%20201.77c0.11-0.87-0.3-1.63-0.93-1.7s-1.23%200.57-1.34%201.44c-0.11%200.86%200.31%201.63%200.93%201.7%200.63%200.07%201.23-0.57%201.34-1.44%22%2F%3E%0A%3Cpath%20d%3D%22m271.38%20201.38c-0.22-0.35-0.32-0.79-0.25-1.23%200.09-0.44%200.33-0.81%200.67-1.07%200%200-0.67-0.71-1.47-1.26-0.61-0.41-1.8-0.82-2.16-0.95-0.35-0.13-1.06-0.4-1.06-0.4s-0.01%200.18%200.06%200.61c0.08%200.52%200.19%200.87%200.19%200.87-1.29-0.14-2.61%200.29-3.6%200.98%200.68%200.97%201.77%201.79%203.03%202.08%200%200-0.23%200.28-0.49%200.74-0.22%200.39-0.28%200.56-0.28%200.56l1.14-0.03c0.38%200%201.66-0.01%202.37-0.2%200.95-0.25%201.84-0.69%201.84-0.69%22%2F%3E%0A%3Cpath%20d%3D%22m274.67%20191.65c-1.06%200.67-1.98%201.79-2.31%203.03%200%200-0.12-0.25-0.71-0.59-0.58-0.33-1.09-0.32-1.09-0.32s0.17%200.97%200.26%201.32c0.09%200.34%200.09%201.38%200.31%202.32%200.23%200.93%200.64%201.68%200.64%201.68%200.42-0.34%200.99-0.51%201.57-0.41%200.59%200.1%201.06%200.44%201.33%200.9%200%200%200.66-0.58%201.21-1.38%200.54-0.81%200.92-1.78%201.12-2.08%200.21-0.3%200.72-1.15%200.72-1.15s-0.47-0.18-1.14-0.05c-0.67%200.12-0.88%200.32-0.88%200.32%200.15-1.28-0.28-2.62-1.03-3.59%22%2F%3E%0A%3Cpath%20d%3D%22m274.22%20201.86c0.34-0.27%200.6-0.64%200.67-1.08%200.09-0.44%200-0.87-0.22-1.23%200%200%200.88-0.44%201.83-0.69%200.72-0.19%201.99-0.2%202.36-0.2%200.39-0.02%201.15-0.03%201.15-0.03s-0.06%200.17-0.28%200.55c-0.26%200.46-0.49%200.75-0.49%200.75%201.26%200.29%202.34%201.12%203.03%202.09-0.99%200.68-2.31%201.1-3.6%200.97%200%200%200.11%200.34%200.19%200.86%200.06%200.43%200.06%200.61%200.06%200.61s-0.71-0.26-1.06-0.39c-0.36-0.13-1.55-0.55-2.16-0.96-0.79-0.54-1.48-1.25-1.48-1.25%22%2F%3E%0A%3Cellipse%20fill%3D%22%23ad1519%22%20cx%3D%22272.98%22%20cy%3D%22200.45%22%20rx%3D%222.17%22%20ry%3D%222.06%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m283.96%20205.91c0.28-0.83%200.03-1.65-0.57-1.83-0.6-0.19-1.32%200.33-1.61%201.16-0.28%200.83-0.03%201.65%200.57%201.84%200.6%200.18%201.32-0.34%201.61-1.17%22%2F%3E%0A%3Cpath%20d%3D%22m291.97%20206.32c0.11-0.37%200.36-0.75%200.72-1.06%200.79-0.68%201.85-0.79%202.36-0.25%200.07%200.07%200.14%200.17%200.18%200.25%200%200%201.1-2.08%202.4-2.78s3.5-0.52%203.5-0.52c0-1.6-1.31-2.89-3-2.89-0.99%200-1.92%200.41-2.47%201.11l-0.23-1.07s-1.36%200.27-1.98%201.82%200.05%203.8%200.05%203.8-0.33-0.96-0.84-1.61c-0.51-0.64-1.81-1.34-2.49-1.66-0.68-0.31-1.37-0.79-1.37-0.79s-0.03%200.18-0.06%200.61c-0.02%200.51%200.02%200.83%200.02%200.83-1.25-0.17-2.7%200.04-3.83%200.48%200.48%200.95%201.4%201.84%202.61%202.3%200%200-0.43%200.36-0.83%200.75-0.33%200.34-0.43%200.49-0.43%200.49s0.85%200.13%201.27%200.19c0.43%200.05%201.84%200.28%202.68%200.22%200.63-0.04%201.32-0.14%201.74-0.22%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m295.05%20205.01c-0.51-0.54-1.57-0.43-2.36%200.25-0.79%200.67-1.02%201.66-0.51%202.19%200.51%200.54%201.57%200.42%202.36-0.25%200.79-0.68%201.02-1.66%200.51-2.19%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22none%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20stroke-linejoin%3D%22round%22%20d%3D%22m250.12%20224.57c-11.06-0.01-21.07-1.29-28.68-3.26%207.61-1.97%2017.62-3.17%2028.68-3.19%2011.07%200.02%2021.13%201.22%2028.74%203.19-7.61%201.97-17.67%203.25-28.74%203.26z%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.05%22%20d%3D%22m258.04%20224.28v-6.01m-3.02%206.21l0.04-6.37m-2.24%206.45v-6.49%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.09%22%20d%3D%22m250.95%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.14%22%20d%3D%22m249.16%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.18%22%20d%3D%22m247.48%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.23%22%20d%3D%22m245.81%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.28%22%20d%3D%22m244.32%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.33%22%20d%3D%22m241.48%20224.28l-0.04-5.97m1.39%206.05v-6.25%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.37%22%20d%3D%22m238.86%20224.01v-5.5m1.33%205.66l-0.04-5.86%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.42%22%20d%3D%22m235.35%20223.7v-4.84m1.15%204.92v-5.08m1.19%205.24v-5.28%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.46%22%20d%3D%22m234.12%20223.66v-4.68%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.51%22%20d%3D%22m232.97%20223.42v-4.36%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.56%22%20d%3D%22m231.74%20223.31v-4.06%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.6%22%20d%3D%22m229.22%20222.95l-0.04-3.22m1.33%203.38v-3.62%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.63%22%20d%3D%22m227.93%20222.68v-2.84%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.68%22%20d%3D%22m226.74%20222.45v-2.36%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.73%22%20d%3D%22m225.45%20222.13v-1.85%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.77%22%20d%3D%22m224.12%20221.98v-1.38%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.91%22%20d%3D%22m222.72%20221.66v-0.67%22%2F%3E%0A%3Cpath%20d%3D%22m220.12%20221.66c7.75-2.18%2018.29-3.52%2030-3.54%2011.72%200.02%2022.31%201.36%2030.06%203.54%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m216.72%20217.16l1.22-1.59%203.37%200.43-2.69%201.96-1.9-0.8%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m224.03%20215.28c0-0.58%200.49-1.04%201.1-1.04s1.1%200.46%201.1%201.04c0%200.57-0.49%201.04-1.1%201.04s-1.1-0.47-1.1-1.04%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m233.64%20215.07l-2.36%200.27c-0.61%200.07-1.17-0.33-1.24-0.9-0.08-0.57%200.35-1.09%200.96-1.15l2.37-0.28%202.42-0.28c0.6-0.07%201.15%200.33%201.22%200.9s-0.36%201.09-0.96%201.16l-2.41%200.28%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m240.54%20213.35c0-0.58%200.49-1.04%201.1-1.04%200.6%200%201.1%200.46%201.1%201.04%200%200.57-0.5%201.04-1.1%201.04-0.61%200-1.1-0.47-1.1-1.04%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m250.15%20214.16h-3.29c-0.6%200-1.11-0.46-1.11-1.03%200-0.58%200.49-1.04%201.1-1.04h6.64c0.61%200%201.1%200.46%201.1%201.04%200%200.57-0.51%201.03-1.11%201.03h-3.33%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m257.56%20213.35c0-0.58%200.5-1.04%201.1-1.04%200.61%200%201.1%200.46%201.1%201.04%200%200.57-0.49%201.04-1.1%201.04-0.6%200-1.1-0.47-1.1-1.04%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m266.66%20215.07l2.36%200.27c0.6%200.07%201.17-0.33%201.24-0.9s-0.36-1.09-0.96-1.15l-2.37-0.28-2.42-0.28c-0.61-0.07-1.15%200.33-1.22%200.9-0.08%200.57%200.36%201.09%200.96%201.16l2.41%200.28%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m274.07%20215.28c0-0.58%200.49-1.04%201.1-1.04s1.1%200.46%201.1%201.04c0%200.57-0.49%201.04-1.1%201.04s-1.1-0.47-1.1-1.04%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m283.57%20217.16l-1.21-1.59-3.37%200.43%202.69%201.96%201.89-0.8%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22shield%22%20stroke-width%3D%220.52%22%3E%0A%3Cg%20id%3D%22Granada%22%3E%0A%3Cpath%20fill%3D%22%23ccc%22%20d%3D%22m250.49%20344.33c-13.08%200-26.05-3.2-36.95-8.54-8.03-3.98-13.36-12-13.36-21.19v-33.3h100.42v33.3c0%209.19-5.32%2017.21-13.36%2021.19-10.9%205.34-23.66%208.54-36.75%208.54z%22%2F%3E%0A%3Cpath%20fill%3D%22%23ffd691%22%20d%3D%22m252.91%20329.55c2.09%200.63%203.15%202.19%203.15%204.01%200%202.38-2.3%204.18-5.3%204.18-2.99%200-5.42-1.8-5.42-4.18%200-1.79%201-3.8%203.08-3.94%200%200-0.06-0.19-0.24-0.5-0.22-0.23-0.64-0.66-0.64-0.66s0.79-0.15%201.25%200.02c0.46%200.18%200.77%200.47%200.77%200.47s0.21-0.43%200.52-0.76c0.3-0.33%200.7-0.53%200.7-0.53s0.46%200.38%200.61%200.64c0.15%200.27%200.25%200.59%200.25%200.59s0.42-0.35%200.79-0.49c0.37-0.15%200.84-0.26%200.84-0.26s-0.13%200.46-0.22%200.69-0.14%200.72-0.14%200.72%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m250.32%20340.32s-3.98-2.68-5.7-3.04c-2.21-0.47-4.69-0.09-5.76-0.15%200.03%200.03%201.29%200.93%201.84%201.48s2.39%201.65%203.43%201.91c3.22%200.81%206.19-0.2%206.19-0.2%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m251.46%20340.56s2.54-2.66%205.21-3.02c3.15-0.44%205.22%200.26%206.44%200.58%200.03%200-1.01%200.49-1.56%200.87-0.55%200.37-1.97%201.57-4.14%201.59-2.18%200.03-4.58-0.23-4.97-0.17-0.4%200.06-0.98%200.15-0.98%200.15%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m250.69%20337.28c-1-0.93-1.62-2.25-1.62-3.72%200-1.46%200.62-2.78%201.63-3.71%200.99%200.93%201.61%202.25%201.61%203.71%200%201.47-0.62%202.79-1.62%203.72%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m249.68%20342.71s0.61-1.52%200.67-2.83c0.06-1.09-0.15-2.17-0.15-2.17h0.52%200.28s0.39%201.16%200.39%202.17c0%201.02-0.18%202.37-0.18%202.37s-0.55%200.08-0.73%200.17c-0.19%200.09-0.8%200.29-0.8%200.29%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22Aragon%22%20fill%3D%22%23c8b100%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m250.32%20314.57c0%2013.16-11.16%2023.82-25.05%2023.82s-25.15-10.66-25.15-23.82v-33.35h50.2v33.35%22%2F%3E%0A%3Cpath%20d%3D%22m200.03%20314.12c0.15%207.02%202.95%2012.25%205.73%2015.67v-49.47h-5.66l-0.07%2033.8z%22%2F%3E%0A%3Cpath%20d%3D%22m211.08%20334.23c1.57%200.83%203.72%202.22%206.03%202.77l-0.15-56.96h-5.88v54.19z%22%2F%3E%0A%3Cpath%20d%3D%22m222.28%20338.25c2.3%200.23%204.01%200.19%205.87%200v-58.21h-5.87v58.21z%22%2F%3E%0A%3Cpath%20d%3D%22m233.32%20337c2.3-0.46%204.9-1.89%206.03-2.63v-54.33h-5.88l-0.15%2056.96z%22%2F%3E%0A%3Cpath%20d%3D%22m244.81%20329.24c2.45-2.18%204.75-7.12%205.59-12.76l0.14-36.44h-5.87l0.14%2049.2z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22Navarre%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m300.65%20281.22v33.35c0%2013.16-11.28%2023.82-25.17%2023.82-13.9%200-25.16-10.66-25.16-23.82v-33.35h50.33%22%2F%3E%0A%3Cpath%20id%3D%22chains_half%22%20fill%3D%22%23c8b100%22%20stroke%3D%22%23c8b100%22%20stroke-width%3D%220.26%22%20d%3D%22m272.71%2C306.14c0.05-0.14%2C0.12-0.27%2C0.19-0.4l-4.26-4.74-1.67%2C0.72-3.06-3.39%2C1-1.46-5.34-5.99c-0.07%2C0.02-0.2%2C0.02-0.27%2C0.04l0.03%2C4.02%2C1.75%2C0.5v4.46l-1.75%2C0.48-0.03%2C4.08c0.84%2C0.26%2C1.48%2C0.88%2C1.74%2C1.67l3.21%2C0.01%2C0.51-1.67h4.72l0.5%2C1.67zm-6.98-18.5%2C0%2C1.61%2C2.76%2C0%2C0-1.61zm-7.3%2C20.37c0.64%2C0%2C1.16-0.49%2C1.16-1.1s-0.52-1.11-1.16-1.11c-0.65%2C0-1.17%2C0.5-1.17%2C1.11s0.52%2C1.1%2C1.17%2C1.1zm15.99-9.73-1.76-0.48%2C0-4.46%2C1.76-0.5-0.01-1.92c-0.85-0.25-1.51-0.87-1.79-1.67h-2.68l-0.51%2C1.67h-4.71l-0.51-1.67h-3.09c-0.08%2C0.22-0.17%2C0.42-0.29%2C0.61l5.38%2C5.96%2C1.67-0.71%2C3.06%2C3.4-1%2C1.45%2C4.18%2C4.64c0.09-0.04%2C0.18-0.08%2C0.28-0.12zm-7.25-1.39-1.29%2C1.04%2C1.77%2C1.98%2C1.29-1.05zm8.00432%2C36.1859c-1.23998-0.065-2.25509-0.9022-2.51432-2.01593-1.67-0.23-3.25-0.66-4.73-1.3l0.84-1.43c1.29%2C0.55%2C2.66%2C0.91%2C4.08%2C1.11%2C0.31-0.66%2C0.86-1.16%2C1.58-1.4l0.01-5.62-1.76-0.49v-4.46l1.76-0.48v-7.64c-0.07-0.02-0.13-0.05-0.2-0.09l-3.98%2C4.42%2C1%2C1.44-3.06%2C3.4-1.67-0.71-3.3%2C3.67c0.57%2C0.87%2C0.55%2C2-0.11%2C2.85%2C0.94%2C1.05%2C2.03%2C1.98%2C3.24%2C2.75l-0.84%2C1.44c-1.42-0.89-2.7-1.99-3.79-3.22-0.87%2C0.26-1.86%2C0.11-2.6-0.5-1.15-0.93-1.29-2.56-0.3-3.64l0.14-0.16c-0.69-1.56-1.16-3.24-1.32-5l1.71%2C0.01c0.14%2C1.5%2C0.51%2C2.93%2C1.09%2C4.27%2C0.49-0.06%2C1-0.01%2C1.46%2C0.16l3.32-3.68-1-1.45%2C3.06-3.4%2C1.67%2C0.72%2C3.99-4.43c-0.09-0.14-0.15-0.29-0.21-0.46l-2.76%2C0.01-0.5%2C1.67h-4.72l-0.51-1.67-3.24-0.01c-0.27%2C0.76-0.9%2C1.36-1.69%2C1.62l-0.01%2C4.04-1.71-0.01v-4.01c-1.1-0.33-1.91-1.31-1.91-2.47%2C0-1.15%2C0.82-2.15%2C1.92-2.48l0.01-4.05-1.76-0.48v-4.46l1.76-0.5v-4.05c-1.08-0.35-1.84-1.32-1.84-2.45%2C0-1.43%2C1.22-2.58%2C2.73-2.58%2C1.22%2C0%2C2.25%2C0.74%2C2.61%2C1.78h3.09l0.51-1.67h4.71l0.51%2C1.67h2.68c0.35692-1.0311%2C1.36258-1.76731%2C2.55896-1.77984l0.0711%2C8.36984h-0.85v2.61h0.845l-0.0214%2C21.59h-0.7836v2.61h0.77946zm-5.914-18.306l-1.29-1.04-1.78%2C1.98%2C1.29%2C1.04zm-9.96-18.44-1.69%2C0-0.01%2C2.61%2C1.7%2C0zm9.16%2C11.41%2C0-1.6-2.85%2C0%2C0%2C1.6zm-10.6%2C9.69-1.76-0.39-0.25-4.45%2C1.75-0.58%2C0%2C2.56c0%2C0.99%2C0.09%2C1.92%2C0.26%2C2.86zm1.46-5.52%2C1.75%2C0.41s0.09%2C2.87%2C0.05%2C2.22c-0.04-0.74%2C0.19%2C2.24%2C0.19%2C2.24l-1.76%2C0.58c-0.18-0.9-0.24-1.84-0.24-2.79zm10.81%2C16.93%2C0.39-1.7c-1.52-0.48-2.93-1.18-4.17-2.09l-1.26%2C1.11c1.48%2C1.15%2C3.19%2C2.08%2C5.04%2C2.68zm-0.85%2C1.44-1.3%2C1.22c-1.47-0.54-2.86-1.26-4.12-2.11l0.38-1.77c1.5%2C1.13%2C3.21%2C2.03%2C5.04%2C2.66z%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23chains_half%22%20transform%3D%22matrix(-1%2C0%2C0%2C1%2C550.43%2C0)%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20stroke%3D%22none%22%20d%3D%22m272.59%20306.94c0-1.44%201.23-2.6%202.74-2.6s2.73%201.16%202.73%202.6c0%201.43-1.22%202.58-2.73%202.58s-2.74-1.15-2.74-2.58%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22Castile%22%20fill%3D%22%23c8b100%22%20stroke-width%3D%220.46%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20stroke-width%3D%220.52%22%20d%3D%22m200.12%20281.25h50.18v-55.72h-50.18v55.72z%22%2F%3E%0A%3Cpath%20d%3D%22m217.34%20238.41h-0.92v-0.92h-1.62v3.69h1.62v2.55h-3.47v7.39h1.85v14.79h-3.7v7.63h28.42v-7.63h-3.69v-14.79h1.85v-7.39h-3.47v-2.55h1.62v-3.69h-1.62v0.92h-0.93v-0.92h-1.61v0.92h-1.16v-0.92h-1.62v3.69h1.62v2.55h-3.46v-8.09h1.84v-3.7h-1.84v0.93h-0.93v-0.93h-1.62v0.93h-0.92v-0.93h-1.85v3.7h1.85v8.09h-3.47v-2.55h1.62v-3.69h-1.62v0.92h-0.92v-0.92h-1.85v0.92zm-6.24%2035.13h28.42m-28.42-1.85h28.42m-28.42-1.85h28.42m-28.42-1.85h28.42m-28.42-2.08h28.42m-24.72-1.62h21.03m-21.03-1.85h21.03m-21.03-2.08h21.03m-21.03-1.84h21.03m-21.03-1.85h21.03m-21.03-1.85h21.03m-21.03-1.85h21.03m-22.88-1.85h24.73m-24.73-1.85h24.73m-24.73-1.85h24.73m-24.73-1.84h24.73m-21.26-1.85h17.79m-10.63-1.85h3.47m-3.47-1.85h3.47m-3.47-1.85h3.47m-3.47-1.85h3.47m-5.32-2.31h7.16m-12.47%207.86h3.69m-5.31-2.31h6.93m-6.93%2033.97v-1.85m0-1.85v-1.85m-1.85%201.85v1.85m3.47%200v-1.85m1.84%203.7v-1.85m0-1.85v-1.85m0-2.08v-1.62m0-1.85v-2.08m-1.84%207.63v-2.08m-3.47%202.08v-2.08m7.16%200v2.08m1.62-2.08v-1.62m-5.31-1.85v1.85m3.69-1.85v1.85m3.47-1.85v1.85m-1.85-1.85v-2.08m1.85-1.84v1.84m0-5.54v1.85m-1.85-3.7v1.85m1.85-3.7v1.85m-3.47-1.85v1.85m-3.69-1.85v1.85m-1.62-3.7v1.85m3.46-1.85v1.85m3.47-1.85v1.85m1.85-3.7v1.85m-3.47-1.85v1.85m-3.69-1.85v1.85m-1.62-3.69v1.84m6.93-1.84v1.84m-3.47-5.54v1.85m15.95-1.85h-3.7m5.32-2.31h-6.94m6.94%2033.97v-1.85m0-1.85v-1.85m1.85%201.85v1.85m-3.47%200v-1.85m-1.85%203.7v-1.85m0-1.85v-1.85m0-2.08v-1.62m0-1.85v-2.08m1.85%207.63v-2.08m3.47%202.08v-2.08m-7.17%200v2.08m-1.62-2.08v-1.62m5.32-1.85v1.85m-3.7-1.85v1.85m-3.46-1.85v1.85m1.84-1.85v-2.08m-1.84-1.84v1.84m0-5.54v1.85m1.84-3.7v1.85m-1.84-3.7v1.85m3.46-1.85v1.85m3.7-1.85v1.85m1.62-3.7v1.85m-3.47-1.85v1.85m-3.47-1.85v1.85m-1.84-3.7v1.85m3.46-1.85v1.85m3.7-1.85v1.85m1.62-3.69v1.84m-6.94-1.84v1.84m3.47-5.54v1.85m-7.16%2018.71v-2.08m0-5.54v-1.85m0%205.55v-1.85m0-5.55v-1.85m0-1.85v-1.84m0-3.7v-1.85m0-1.85v-1.85m-8.78%204.85h3.69m3.47-5.54h3.47m3.46%205.54h3.7%22%2F%3E%0A%3Cpath%20d%3D%22m230.05%20273.54v-4.86c0-0.92-0.46-3.7-4.85-3.7-4.16%200-4.62%202.78-4.62%203.7v4.86h9.47z%22%2F%3E%0A%3Cpath%20d%3D%22m222.19%20268.91l-2.31-0.23c0-0.92%200.23-2.31%200.93-2.77l2.08%201.62c-0.23%200.23-0.7%200.92-0.7%201.38z%22%2F%3E%0A%3Cpath%20d%3D%22m226.12%20266.6l1.16-2.08c-0.46-0.23-1.39-0.46-2.08-0.46-0.46%200-1.39%200.23-1.85%200.46l1.15%202.08h1.62z%22%2F%3E%0A%3Cpath%20d%3D%22m228.43%20268.91l2.31-0.23c0-0.92-0.23-2.31-0.92-2.77l-2.08%201.62c0.23%200.23%200.69%200.92%200.69%201.38z%22%2F%3E%0A%3Cpath%20d%3D%22m221.73%20260.83v-5.09c0-1.38-0.92-2.54-2.54-2.54s-2.54%201.16-2.54%202.54v5.09h5.08z%22%2F%3E%0A%3Cpath%20d%3D%22m228.89%20260.83v-5.09c0-1.38%200.93-2.54%202.55-2.54%201.61%200%202.54%201.16%202.54%202.54v5.09h-5.09z%22%2F%3E%0A%3Cpath%20d%3D%22m220.11%20248.35l0.23-4.62h-4.39l0.47%204.62h3.69z%22%2F%3E%0A%3Cpath%20d%3D%22m227.05%20248.35l0.46-4.62h-4.39l0.23%204.62h3.7z%22%2F%3E%0A%3Cpath%20d%3D%22m230.51%20248.35l-0.46-4.62h4.62l-0.46%204.62h-3.7z%22%2F%3E%0A%3Cg%20fill%3D%22%230039f0%22%20stroke%3D%22none%22%3E%0A%3Cpath%20d%3D%22m228.43%20273.54v-4.16c0-0.7-0.46-2.78-3.23-2.78-2.54%200-3.01%202.08-3.01%202.78v4.16h6.24z%22%2F%3E%0A%3Cpath%20d%3D%22m221.27%20260.36v-4.39c0-1.15-0.69-2.31-2.08-2.31s-2.08%201.16-2.08%202.31v4.39h4.16z%22%2F%3E%0A%3Cpath%20d%3D%22m229.36%20260.36v-4.39c0-1.15%200.69-2.31%202.08-2.31%201.38%200%202.08%201.16%202.08%202.31v4.39h-4.16z%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22Leon%22%3E%0A%3Cpath%20fill%3D%22%23ccc%22%20d%3D%22m250.28%20281.25h50.32v-55.72h-50.32v55.72z%22%2F%3E%0A%3Cpath%20fill%3D%22%23db4446%22%20stroke-width%3D%220.39%22%20d%3D%22m275.93%20239.26l0.05-0.62%200.09-0.34s-1.61%200.13-2.46-0.11-1.61-0.59-2.4-1.25c-0.79-0.68-1.1-1.1-1.67-1.18-1.36-0.22-2.4%200.4-2.4%200.4s1.02%200.37%201.78%201.31%201.59%201.41%201.95%201.53c0.59%200.18%202.66%200.05%203.22%200.07%200.57%200.03%201.84%200.19%201.84%200.19z%22%2F%3E%0A%3Cg%20fill%3D%22none%22%20stroke-width%3D%220.39%22%3E%0A%3Cpath%20fill%3D%22%23ed72aa%22%20d%3D%22m283.46%20237s0.01%200.72%200.08%201.4c0.06%200.67-0.22%201.24-0.11%201.61s0.16%200.66%200.3%200.93c0.14%200.26%200.21%200.94%200.21%200.94s-0.38-0.28-0.74-0.54c-0.35-0.27-0.6-0.44-0.6-0.44s0.07%200.72%200.1%201.03c0.04%200.31%200.22%200.89%200.51%201.24%200.29%200.33%200.87%200.89%201.05%201.33%200.18%200.45%200.14%201.44%200.14%201.44s-0.46-0.75-0.87-0.89c-0.39-0.14-1.26-0.62-1.26-0.62s0.79%200.79%200.79%201.55c0%200.75-0.32%201.6-0.32%201.6s-0.36-0.68-0.83-1.12c-0.47-0.45-1.13-0.9-1.13-0.9s0.52%201.17%200.52%201.95c0%200.79-0.15%202.47-0.15%202.47s-0.39-0.64-0.79-0.96c-0.4-0.31-0.87-0.58-1.02-0.78-0.14-0.21%200.48%200.64%200.54%201.16%200.07%200.51%200.32%202.35%201.92%204.69%200.94%201.37%202.39%203.77%205.5%202.98%203.11-0.78%201.96-4.97%201.3-6.92-0.65-1.95-0.98-4.11-0.94-4.87%200.04-0.75%200.58-2.97%200.51-3.39-0.07-0.41-0.24-2%200.14-3.28%200.4-1.33%200.73-1.85%200.95-2.4%200.21-0.55%200.39-0.86%200.46-1.34s0.07-1.37%200.07-1.37%200.58%201.06%200.73%201.44c0.14%200.38%200.14%201.5%200.14%201.5s0.11-1.12%200.98-1.67%201.88-1.13%202.13-1.44%200.33-0.51%200.33-0.51-0.08%201.92-0.62%202.67c-0.36%200.49-1.77%202.09-1.77%202.09s0.73-0.28%201.23-0.3c0.51-0.04%200.87%200%200.87%200s-0.62%200.48-1.41%201.64c-0.8%201.16-0.47%201.26-1.05%202.22s-1.05%201-1.78%201.58c-1.08%200.87-0.5%204.34-0.36%204.86%200.15%200.51%202.03%204.76%202.07%205.79%200.03%201.03%200.21%203.33-1.6%204.8-1.16%200.95-3.07%200.96-3.51%201.23-0.43%200.28-1.29%201.13-1.29%202.91%200%201.79%200.64%202.06%201.15%202.51%200.51%200.44%201.16%200.2%201.3%200.55%200.15%200.34%200.22%200.54%200.44%200.75%200.21%200.2%200.36%200.44%200.29%200.82-0.08%200.38-0.91%201.23-1.2%201.85-0.29%200.61-0.87%202.23-0.87%202.47s-0.07%200.99%200.18%201.37c0%200%200.91%201.06%200.29%201.26-0.4%200.14-0.78-0.25-0.97-0.2-0.54%200.14-0.83%200.47-0.98%200.45-0.36-0.07-0.36-0.25-0.4-0.76-0.03-0.51-0.01-0.72-0.17-0.72-0.22%200-0.33%200.18-0.37%200.45s-0.04%200.89-0.29%200.89-0.61-0.45-0.83-0.55-0.83-0.2-0.87-0.48c-0.03-0.27%200.36-0.85%200.76-0.96%200.4-0.1%200.76-0.3%200.51-0.51-0.26-0.2-0.51-0.2-0.76%200-0.25%200.21-0.79%200.04-0.76-0.27%200.04-0.31%200.11-0.69%200.07-0.86-0.03-0.17-0.47-0.51%200.1-0.82%200.59-0.31%200.84%200.27%201.42%200.17s0.86-0.31%201.08-0.65%200.18-1.06-0.22-1.5c-0.39-0.45-0.79-0.52-0.94-0.8-0.14-0.27-0.36-0.92-0.36-0.92s0.11%201.2%200.04%201.37-0.04%200.89-0.04%200.89-0.39-0.45-0.72-0.79c-0.32-0.34-0.65-1.37-0.65-1.37s-0.03%200.96-0.03%201.34c0%200.37%200.43%200.72%200.29%200.86-0.15%200.13-0.83-0.72-1.02-0.86-0.18-0.14-0.76-0.58-1.01-1.06s-0.44-1.16-0.51-1.41c-0.07-0.24-0.19-1.31-0.07-1.58%200.18-0.4%200.47-1.13%200.47-1.13h-1.41c-0.76%200-1.3-0.23-1.59%200.28s-0.15%201.54%200.21%202.88c0.37%201.33%200.58%201.98%200.48%202.22-0.11%200.24-0.58%200.79-0.76%200.89-0.19%200.11-0.69%200.07-0.91-0.03-0.21-0.1-0.57-0.27-1.26-0.27s-1.12%200.03-1.37-0.03c-0.26-0.07-0.88-0.38-1.17-0.31s-0.79%200.32-0.65%200.72c0.22%200.61-0.21%200.75-0.51%200.72-0.29-0.04-0.53-0.14-0.9-0.24-0.36-0.11-0.9%200-0.83-0.42%200.07-0.41%200.22-0.44%200.4-0.74%200.18-0.32%200.25-0.52%200.04-0.54-0.25-0.02-0.51-0.05-0.7%200.11-0.2%200.16-0.51%200.51-0.76%200.38-0.26-0.14-0.46-0.43-0.46-1.08%200-0.64-0.68-1.2-0.05-1.17%200.62%200.03%201.41%200.48%201.55%200.13s0.06-0.51-0.28-0.78-0.76-0.43-0.31-0.77c0.45-0.35%200.56-0.35%200.74-0.54%200.17-0.18%200.41-0.79%200.73-0.64%200.62%200.3%200.02%200.73%200.65%201.42%200.62%200.69%201.01%200.94%202.06%200.83%201.04-0.11%201.33-0.24%201.33-0.54%200-0.29-0.09-0.82-0.12-1.04-0.02-0.21%200.15-0.99%200.15-0.99s-0.48%200.3-0.63%200.59c-0.13%200.29-0.42%200.8-0.42%200.8s-0.11-0.6-0.08-1.09c0.02-0.29%200.12-0.79%200.11-0.89-0.03-0.27-0.23-0.94-0.23-0.94s-0.16%200.73-0.28%200.94c-0.11%200.21-0.16%201.07-0.16%201.07s-0.67-0.58-0.48-1.55c0.13-0.75-0.12-1.74%200.11-2.06%200.22-0.33%200.75-1.64%202.06-1.69%201.3-0.05%202.31%200.05%202.77%200.03%200.45-0.03%202.06-0.33%202.06-0.33s-2.97-1.52-3.64-1.98c-0.68-0.45-1.73-1.63-2.07-2.16-0.34-0.54-0.65-1.58-0.65-1.58s-0.53%200.02-1.02%200.29c-0.48%200.27-0.96%200.67-1.24%200.99s-0.73%201.05-0.73%201.05%200.08-0.94%200.08-1.23-0.06-0.86-0.06-0.86-0.33%201.28-1.01%201.76c-0.68%200.49-1.47%201.15-1.47%201.15s0.08-0.71%200.08-0.88c0-0.16%200.17-0.99%200.17-0.99s-0.48%200.72-1.21%200.86c-0.74%200.13-1.81%200.11-1.9%200.56-0.08%200.45%200.2%201.07%200.03%201.39s-0.54%200.54-0.54%200.54-0.42-0.35-0.79-0.38c-0.36-0.03-0.71%200.16-0.71%200.16s-0.31-0.4-0.19-0.67c0.11-0.26%200.67-0.66%200.54-0.83-0.15-0.16-0.6%200.06-0.88%200.19-0.28%200.14-0.88%200.27-0.82-0.19%200.05-0.45%200.2-0.72%200.05-1.04-0.14-0.32-0.05-0.53%200.18-0.61%200.22-0.08%201.12%200.02%201.21-0.19%200.08-0.21-0.22-0.48-0.82-0.61-0.59-0.14-0.88-0.49-0.57-0.78%200.32-0.3%200.4-0.38%200.54-0.64%200.14-0.27%200.2-0.76%200.74-0.51%200.53%200.24%200.42%200.83%200.99%201.01%200.56%200.19%201.89-0.08%202.17-0.24s1.19-0.83%201.5-0.99c0.31-0.15%201.61-1.12%201.61-1.12s-0.76-0.53-1.05-0.8c-0.28-0.27-0.78-0.91-1.04-1.05-0.25-0.13-1.5-0.61-1.92-0.64-0.42-0.02-1.72-0.48-1.72-0.48s0.59-0.19%200.79-0.35c0.19-0.16%200.64-0.56%200.87-0.53%200.22%200.02%200.28%200.02%200.28%200.02s-1.21-0.05-1.47-0.13c-0.25-0.08-0.99-0.54-1.27-0.54s-0.84%200.11-0.84%200.11%200.76-0.48%201.38-0.59c0.62-0.1%201.1-0.08%201.1-0.08s-0.96-0.27-1.19-0.58c-0.22-0.33-0.45-0.8-0.62-1.02-0.17-0.21-0.28-0.56-0.59-0.59s-0.85%200.38-1.16%200.35-0.54-0.22-0.57-0.67c-0.02-0.46%200-0.3-0.1-0.54-0.12-0.24-0.57-0.8-0.15-0.93%200.43-0.14%201.33%200.08%201.42-0.08%200.08-0.16-0.48-0.65-0.85-0.83-0.37-0.19-0.96-0.51-0.65-0.78%200.31-0.26%200.62-0.37%200.79-0.61s0.37-0.91%200.74-0.7c0.36%200.21%200.87%201.26%201.16%201.18%200.28-0.08%200.3-0.83%200.25-1.15-0.06-0.32%200-0.88%200.28-0.83s0.51%200.43%200.96%200.46c0.45%200.02%201.13-0.11%201.07%200.21-0.05%200.32-0.31%200.71-0.62%201.06-0.3%200.36-0.45%201.05-0.25%201.5%200.2%200.46%200.71%201.19%201.16%201.48s1.3%200.51%201.84%200.85c0.53%200.35%201.78%201.34%202.2%201.45s0.85%200.32%200.85%200.32%200.48-0.21%201.13-0.21%202.14%200.1%202.71-0.14%201.3-0.64%201.08-1.15c-0.23-0.51-1.47-0.96-1.36-1.36s0.57-0.43%201.33-0.46c0.76-0.02%201.8%200.14%202-0.94%200.2-1.06%200.26-1.68-0.81-1.92-1.08-0.24-1.87-0.27-2.07-1.04-0.2-0.78-0.39-0.97-0.17-1.18%200.23-0.21%200.62-0.32%201.41-0.37%200.8-0.06%201.7-0.06%201.96-0.25%200.25-0.18%200.3-0.69%200.61-0.91%200.31-0.21%201.53-0.4%201.53-0.4s1.46%200.71%202.8%201.71c1.21%200.9%202.3%202.23%202.3%202.23%22%2F%3E%0A%3Cpath%20d%3D%22m269%20243.39s-0.8%200.23-1.1%200.67c-0.37%200.53-0.34%201.07-0.34%201.07s0.68-0.56%201.56-0.33c0.87%200.24%200.96%200.33%201.33%200.3s1.27-0.35%201.27-0.35-0.74%200.86-0.65%201.45c0.08%200.58%200.19%200.85%200.17%201.15-0.06%200.72-0.6%201.61-0.6%201.61s0.31-0.19%201.05-0.35c0.73-0.16%201.36-0.51%201.75-0.81%200.39-0.29%200.9-1.02%200.9-1.02s-0.16%201%200%201.42c0.17%200.44%200.23%201.67%200.23%201.67s0.47-0.42%200.85-0.62c0.19-0.11%200.7-0.38%200.9-0.7%200.14-0.22%200.32-1.06%200.32-1.06s0.11%200.9%200.39%201.34c0.28%200.42%200.7%201.74%200.7%201.74s0.29-0.86%200.6-1.21%200.68-0.8%200.7-1.07c0.03-0.27-0.08-0.85-0.08-0.85l0.39%200.85m-11.41%200.61s0.48-0.83%200.93-1.1c0.46-0.26%201.08-0.74%201.25-0.8%200.16-0.05%200.9-0.46%200.9-0.46m0.99%205.17s1.09-0.55%201.41-0.75c0.68-0.4%201.16-1.12%201.16-1.12%22%2F%3E%0A%3Cpath%20fill%3D%22none%22%20stroke-width%3D%220.26%22%20d%3D%22m282.57%20240.9s-0.34-0.48-0.42-0.65c-0.09-0.15-0.23-0.48-0.23-0.48%22%2F%3E%0A%3Cpath%20fill%3D%22none%22%20d%3D%22m278.33%20257.41s2.04%201.26%201.98%202.31c-0.06%201.04-1.13%202.41-1.13%202.41%22%2F%3E%0A%3C%2Fg%3E%0A%3Cpath%20fill%3D%22%23000%22%20stroke-width%3D%220.26%22%20d%3D%22m273.05%20236.24s-0.17-0.48-0.2-0.62c-0.03-0.13-0.12-0.29-0.12-0.29s0.88%200%200.85%200.27c-0.02%200.27-0.28%200.27-0.34%200.37-0.05%200.11-0.19%200.27-0.19%200.27z%22%2F%3E%0A%3Cpath%20fill%3D%22%23000%22%20stroke-width%3D%220.05%22%20d%3D%22m277.06%20234.85l-0.06-0.43s0.77%200%201.13%200.26c0.57%200.4%200.93%201.02%200.91%201.05-0.1%200.09-0.54-0.27-0.85-0.37%200%200-0.23%200.05-0.45%200.05-0.23%200-0.34-0.11-0.37-0.21-0.03-0.12%200.03-0.3%200.03-0.3l-0.34-0.05z%22%2F%3E%0A%3Cg%20fill%3D%22%23000%22%20stroke-width%3D%220.26%22%3E%0A%3Cpath%20d%3D%22m273.08%20240.14l0.33-0.53%200.34%200.49-0.67%200.04%22%2F%3E%0A%3Cpath%20d%3D%22m273.89%20240.12l0.4-0.53%200.43%200.48-0.83%200.05%22%2F%3E%0A%3Cpath%20d%3D%22m273.53%20236.83l0.82%200.29-0.74%200.38-0.08-0.67%22%2F%3E%0A%3Cpath%20d%3D%22m274.52%20237.1l0.73%200.18-0.59%200.46-0.14-0.64%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22%23db4446%22%20stroke-width%3D%220.39%22%3E%0A%3Cpath%20d%3D%22m261.88%20236.08s0.48%200.34%200.85%200.4c0.37%200.05%200.76%200.05%200.82%200.05%200.05%200%200.17-0.54%200.11-0.91-0.2-1.2-1.3-1.47-1.3-1.47s0.33%200.73%200.17%201.07c-0.23%200.48-0.65%200.86-0.65%200.86z%22%2F%3E%0A%3Cpath%20d%3D%22m259.59%20237.12s-0.43-0.77-1.33-0.67c-0.9%200.11-1.5%200.81-1.5%200.81s1-0.03%201.25%200.13c0.37%200.24%200.48%200.86%200.48%200.86s0.54-0.32%200.71-0.54c0.16-0.21%200.39-0.59%200.39-0.59z%22%2F%3E%0A%3Cpath%20d%3D%22m258.49%20240.25s-0.77%200.11-1.19%200.59c-0.43%200.49-0.36%201.4-0.36%201.4s0.5-0.54%200.95-0.54c0.46%200%201.16%200.16%201.16%200.16s-0.22-0.56-0.22-0.8-0.34-0.81-0.34-0.81z%22%2F%3E%0A%3Cpath%20d%3D%22m261.06%20250.37s-0.42-0.45-1.16-0.32c-0.74%200.14-1.22%200.97-1.22%200.97s0.63-0.17%201-0.08c0.36%200.08%200.62%200.45%200.62%200.45s0.34-0.29%200.45-0.45%200.31-0.57%200.31-0.57z%22%2F%3E%0A%3Cpath%20d%3D%22m260.21%20253.34s-0.62-0.1-1.16%200.33c-0.53%200.43-0.56%201.25-0.56%201.25s0.51-0.43%200.91-0.37c0.39%200.05%200.87%200.27%200.87%200.27s0.08-0.51%200.11-0.64c0.09-0.38-0.17-0.84-0.17-0.84z%22%2F%3E%0A%3Cpath%20d%3D%22m261.66%20256.08s-0.05%200.79%200.33%201.28c0.4%200.51%201.13%200.59%201.13%200.59s-0.24-0.53-0.28-0.8c-0.06-0.4%200.34-0.75%200.34-0.75s-0.37-0.38-0.73-0.38c-0.37%200-0.79%200.06-0.79%200.06z%22%2F%3E%0A%3Cpath%20d%3D%22m269%20263.12s-0.51-0.64-1.21-0.62c-0.71%200.03-1.45%200.69-1.45%200.69s0.88-0.07%201.11%200.22c0.23%200.3%200.45%200.67%200.45%200.67s0.4-0.21%200.57-0.35c0.17-0.13%200.53-0.61%200.53-0.61z%22%2F%3E%0A%3Cpath%20d%3D%22m266.83%20265.93s-0.93-0.14-1.39%200.35c-0.45%200.48-0.42%201.36-0.42%201.36s0.56-0.61%201.07-0.56%201.08%200.32%201.08%200.32-0.09-0.53-0.15-0.78c-0.05-0.24-0.19-0.69-0.19-0.69z%22%2F%3E%0A%3Cpath%20d%3D%22m268.84%20268.9s-0.46%200.64-0.12%201.15%201.05%200.75%201.05%200.75-0.26-0.37-0.14-0.8c0.09-0.34%200.67-0.8%200.67-0.8l-1.46-0.3z%22%2F%3E%0A%3Cpath%20d%3D%22m281.24%20270.11s-0.81-0.19-1.27%200.08c-0.45%200.26-0.82%201.39-0.82%201.39s0.74-0.62%201.28-0.54c0.53%200.08%200.93%200.3%200.93%200.3s0.08-0.46%200.02-0.78c-0.03-0.19-0.14-0.45-0.14-0.45z%22%2F%3E%0A%3Cpath%20d%3D%22m281.64%20273.1s-0.62%200.64-0.4%201.18c0.23%200.54%200.62%201.1%200.62%201.1s-0.02-0.8%200.23-1.02c0.37-0.32%201.05-0.37%201.05-0.37s-0.54-0.48-0.71-0.54c-0.17-0.05-0.79-0.35-0.79-0.35z%22%2F%3E%0A%3Cpath%20d%3D%22m284.75%20274.04s-0.31%200.78%200.28%201.28c0.59%200.52%201.11%200.57%201.11%200.57s-0.46-0.81-0.32-1.23c0.15-0.45%200.54-0.72%200.54-0.72s-0.74-0.25-0.85-0.22c-0.11%200.02-0.76%200.32-0.76%200.32z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22%23c8b100%22%20stroke-width%3D%220.26%22%3E%0A%3Cpath%20d%3D%22m282.88%20232.71l-0.29%200.02c-0.01%200.03-0.14%200.24-0.26%200.35-0.26%200.25-0.65%200.28-0.86%200.07-0.11-0.11-0.16-0.26-0.14-0.41-0.17%200.09-0.35%200.09-0.51-0.01-0.26-0.15-0.32-0.5-0.14-0.79%200.03-0.06%200.06-0.14%200.11-0.18l-0.02-0.32-0.35%200.08-0.1%200.19c-0.22%200.25-0.54%200.31-0.7%200.17-0.08-0.07-0.14-0.26-0.13-0.27%200%200.01-0.09%200.09-0.17%200.11-0.54%200.13-0.75-1.05-0.77-1.35l-0.17%200.25s0.16%200.7%200.08%201.3c-0.08%200.59-0.29%201.19-0.29%201.19%200.74%200.19%201.86%200.8%202.97%201.65s1.98%201.78%202.34%202.42c0%200%200.58-0.32%201.18-0.51s1.36-0.2%201.36-0.2l0.22-0.21c-0.32%200.05-1.58%200.1-1.56-0.43%200-0.08%200.07-0.18%200.08-0.18-0.01%200.01-0.21-0.01-0.3-0.06-0.18-0.13-0.18-0.43%200.02-0.69l0.18-0.13%200.01-0.34-0.34%200.05c-0.03%200.04-0.11%200.09-0.15%200.13-0.27%200.23-0.65%200.25-0.86%200.03-0.13-0.12-0.17-0.29-0.11-0.46-0.16%200.04-0.32%200.03-0.45-0.05-0.26-0.15-0.31-0.52-0.11-0.8%200.09-0.14%200.28-0.31%200.31-0.32l-0.07-0.3h-0.01z%22%2F%3E%0A%3Cg%20fill%3D%22%23000%22%20stroke-width%3D%220.05%22%3E%0A%3Cpath%20d%3D%22m280.63%20233.4c0.05-0.07%200.15-0.06%200.23%200s0.1%200.16%200.06%200.21c-0.05%200.06-0.15%200.06-0.24-0.01-0.07-0.05-0.1-0.15-0.05-0.2z%22%2F%3E%0A%3Cpath%20d%3D%22m281.58%20234.19l-0.33-0.25c-0.06-0.04-0.07-0.12-0.04-0.16%200.04-0.04%200.12-0.04%200.18%200l0.33%200.26%200.33%200.25c0.05%200.04%200.08%200.12%200.04%200.16s-0.12%200.04-0.18%200l-0.33-0.26%22%2F%3E%0A%3Cpath%20d%3D%22m279.84%20233l-0.26-0.15c-0.07-0.04-0.1-0.12-0.07-0.17s0.11-0.06%200.17-0.02l0.26%200.16%200.26%200.15c0.06%200.03%200.09%200.11%200.07%200.16-0.03%200.05-0.11%200.06-0.17%200.02l-0.26-0.15%22%2F%3E%0A%3Cpath%20d%3D%22m278.8%20232.29c0.05-0.06%200.16-0.06%200.24%200%200.08%200.07%200.1%200.16%200.05%200.22-0.05%200.05-0.15%200.05-0.23-0.01s-0.1-0.15-0.06-0.21z%22%2F%3E%0A%3Cpath%20d%3D%22m282.63%20234.92c0.05-0.05%200.03-0.14-0.05-0.21-0.08-0.06-0.19-0.06-0.24%200-0.04%200.05-0.02%200.15%200.06%200.21s0.18%200.06%200.23%200z%22%2F%3E%0A%3Cpath%20d%3D%22m283.2%20235.58l0.22%200.21c0.05%200.05%200.13%200.07%200.18%200.03%200.04-0.04%200.04-0.11-0.01-0.16l-0.21-0.21-0.22-0.21c-0.05-0.05-0.14-0.07-0.18-0.03-0.05%200.03-0.04%200.11%200.01%200.16l0.21%200.21%22%2F%3E%0A%3Cpath%20d%3D%22m284.15%20236.39c0.05-0.06%200.03-0.15-0.05-0.21-0.08-0.07-0.18-0.07-0.23-0.01s-0.03%200.15%200.05%200.22c0.08%200.05%200.18%200.06%200.23%200z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cpath%20d%3D%22m281.4%20230.36l-0.59%200.01-0.11%200.87%200.06%200.14%200.15-0.01%200.76-0.51-0.27-0.5%22%2F%3E%0A%3Cpath%20d%3D%22m281.4%20230.36l-0.59%200.01-0.11%200.87%200.06%200.14%200.15-0.01%200.76-0.51-0.27-0.5%22%2F%3E%0A%3Cpath%20d%3D%22m279.8%20230.84l-0.02%200.54%200.92%200.12%200.15-0.07-0.02-0.15-0.53-0.71-0.5%200.27%22%2F%3E%0A%3Cpath%20d%3D%22m281.7%20231.92l-0.49%200.27-0.54-0.71-0.01-0.15%200.14-0.06%200.93%200.11-0.03%200.54%22%2F%3E%0A%3Cpath%20d%3D%22m280.51%20231.25c0.08-0.13%200.26-0.17%200.39-0.09%200.14%200.07%200.18%200.24%200.1%200.37s-0.26%200.17-0.39%200.09c-0.14-0.08-0.18-0.24-0.1-0.37z%22%2F%3E%0A%3Cpath%20d%3D%22m278.36%20230.35c-0.02%200.01-0.13-0.46-0.26-0.71-0.08-0.19-0.39-0.43-0.39-0.43%200.03-0.05%200.42-0.19%200.87%200.09%200.38%200.31-0.03%200.87-0.03%200.87s-0.09%200.14-0.19%200.18z%22%2F%3E%0A%3Cpath%20d%3D%22m279.39%20230.66l-0.42%200.37-0.68-0.6%200.06-0.08%200.03-0.15%200.92-0.07%200.09%200.53%22%2F%3E%0A%3Cpath%20d%3D%22m278.24%20230.29c0.05-0.15%200.18-0.23%200.28-0.2%200.11%200.04%200.15%200.18%200.1%200.33s-0.18%200.23-0.29%200.2c-0.11-0.04-0.15-0.18-0.09-0.33z%22%2F%3E%0A%3Cpath%20d%3D%22m283.67%20231.77l-0.59-0.06-0.25%200.85%200.05%200.14%200.15%200.01%200.83-0.41-0.19-0.53%22%2F%3E%0A%3Cpath%20d%3D%22m282.01%20232.03l-0.1%200.54%200.9%200.23%200.15-0.04%200.01-0.14-0.43-0.79-0.53%200.2%22%2F%3E%0A%3Cpath%20d%3D%22m283.73%20233.36l-0.53%200.2-0.42-0.78%200.01-0.15%200.15-0.03%200.89%200.23-0.1%200.53%22%2F%3E%0A%3Cpath%20d%3D%22m282.65%20232.54c0.1-0.12%200.28-0.13%200.4-0.04%200.13%200.09%200.15%200.26%200.05%200.38s-0.28%200.13-0.41%200.04c-0.12-0.09-0.14-0.26-0.04-0.38z%22%2F%3E%0A%3Cpath%20d%3D%22m285.64%20233.61l0.11%200.55-0.87%200.3-0.16-0.04-0.01-0.14%200.36-0.81%200.57%200.14%22%2F%3E%0A%3Cpath%20d%3D%22m285.49%20235.2l-0.56%200.13-0.31-0.83%200.04-0.15%200.15-0.02%200.85%200.35-0.17%200.52%22%2F%3E%0A%3Cpath%20d%3D%22m283.97%20233.66l-0.18%200.52%200.85%200.34%200.16-0.02%200.03-0.14-0.3-0.83-0.56%200.13%22%2F%3E%0A%3Cpath%20d%3D%22m284.91%20234.63c0.12-0.11%200.12-0.28%200.02-0.39-0.11-0.11-0.29-0.11-0.41-0.02-0.11%200.11-0.12%200.28-0.01%200.39%200.1%200.11%200.29%200.12%200.4%200.02z%22%2F%3E%0A%3Cpath%20d%3D%22m286.29%20236.43c0%200.01%200.5%200.03%200.79%200.09%200.2%200.04%200.52%200.27%200.52%200.27%200.06-0.04%200.12-0.42-0.28-0.79-0.39-0.28-0.88%200.22-0.88%200.22s-0.12%200.12-0.15%200.21z%22%2F%3E%0A%3Cpath%20d%3D%22m285.75%20235.54l-0.29%200.46%200.76%200.51%200.09-0.08%200.13-0.04-0.12-0.88-0.57%200.03%22%2F%3E%0A%3Cpath%20d%3D%22m286.37%20236.53c0.14-0.07%200.21-0.22%200.15-0.31s-0.22-0.1-0.36-0.02-0.2%200.22-0.14%200.31c0.05%200.09%200.21%200.1%200.35%200.02z%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22inescutcheon%22%20stroke-width%3D%220.61%22%3E%0A%3Cellipse%20fill%3D%22%23ad1519%22%20cx%3D%22250.43%22%20cy%3D%22281.01%22%20rx%3D%2216.26%22%20ry%3D%2218.3%22%2F%3E%0A%3Cellipse%20fill%3D%22%23005bbf%22%20cx%3D%22250.44%22%20cy%3D%22280.97%22%20rx%3D%2211.44%22%20ry%3D%2213.42%22%2F%3E%0A%3Cg%20id%3D%22fdl%22%20fill%3D%22%23c8b100%22%20stroke-width%3D%220.34%22%3E%0A%3Cpath%20stroke-linejoin%3D%22round%22%20d%3D%22m245.03%20271.74s-1.35%201.48-1.35%202.86c0%201.39%200.57%202.54%200.57%202.54-0.21-0.55-0.76-0.94-1.41-0.94-0.83%200-1.5%200.63-1.5%201.42%200%200.22%200.14%200.58%200.24%200.77l0.49%200.99c0.16-0.37%200.54-0.57%200.98-0.57%200.59%200%201.08%200.45%201.08%201.01%200%200.09-0.01%200.17-0.04%200.25l-1.22%200.01v1.03h1.09l-0.81%201.61%201.07-0.42%200.81%200.91%200.84-0.91%201.07%200.42-0.8-1.61h1.08v-1.03l-1.22-0.01c-0.02-0.08-0.02-0.16-0.02-0.25%200-0.56%200.47-1.01%201.06-1.01%200.44%200%200.82%200.2%200.98%200.57l0.49-0.99c0.1-0.19%200.24-0.55%200.24-0.77%200-0.79-0.67-1.42-1.49-1.42-0.66%200-1.21%200.39-1.41%200.94%200%200%200.57-1.15%200.57-2.54%200-1.38-1.39-2.86-1.39-2.86z%22%2F%3E%0A%3Cpath%20d%3D%22m242.87%20281.11h4.36v-1.03h-4.36v1.03z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23fdl%22%20x%3D%2210.63%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23fdl%22%20x%3D%225.31%22%20y%3D%229.14%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3C%2Fsvg%3E)
%22%3E%3Ccircle%20r%3D%2220%22%20fill%3D%22%23008%22%2F%3E%3Ccircle%20r%3D%2217.5%22%20fill%3D%22%23fff%22%2F%3E%3Ccircle%20r%3D%223.5%22%20fill%3D%22%23008%22%2F%3E%3Cg%20id%3D%22d%22%3E%3Cg%20id%3D%22c%22%3E%3Cg%20id%3D%22b%22%3E%3Cg%20id%3D%22a%22%3E%3Ccircle%20r%3D%220.875%22%20fill%3D%22%23008%22%20transform%3D%22rotate(7.5)%20translate(17.5)%22%2F%3E%3Cpath%20fill%3D%22%23008%22%20d%3D%22M%200%2C17.5%200.6%2C7%20C%200.6%2C7%200%2C2%200%2C2%200%2C2%20-0.6%2C7%20-0.6%2C7%20L%200%2C17.5%20z%22%2F%3E%3C%2Fg%3E%3Cuse%20xlink%3Ahref%3D%22%23a%22%20transform%3D%22rotate(15)%22%2F%3E%3C%2Fg%3E%3Cuse%20xlink%3Ahref%3D%22%23b%22%20transform%3D%22rotate(30)%22%2F%3E%3C%2Fg%3E%3Cuse%20xlink%3Ahref%3D%22%23c%22%20transform%3D%22rotate(60)%22%2F%3E%3C%2Fg%3E%3Cuse%20xlink%3Ahref%3D%22%23d%22%20transform%3D%22rotate(120)%22%2F%3E%3Cuse%20xlink%3Ahref%3D%22%23d%22%20transform%3D%22rotate(-120)%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E)
%20-%20http%3A%2F%2Fwww.bohemiancoding.com%2Fsketch%20--%3E%0A%20%20%20%20%3Ctitle%3EInterlingua%20Logo%3C%2Ftitle%3E%0A%20%20%20%20%3Cdesc%3ECreated%20with%20Sketch.%3C%2Fdesc%3E%0A%20%20%20%20%3Cdefs%3E%3C%2Fdefs%3E%0A%20%20%20%20%3Cg%20id%3D%22Page-1%22%20stroke%3D%22none%22%20stroke-width%3D%221%22%20fill%3D%22none%22%20fill-rule%3D%22evenodd%22%20sketch%3Atype%3D%22MSPage%22%3E%0A%20%20%20%20%20%20%20%20%3Cpath%20d%3D%22M607%2C807%20C829.570754%2C807%201010%2C626.570754%201010%2C404%20C1010%2C181.429246%20829.570754%2C1%20607%2C1%20C384.429246%2C1%20204%2C181.429246%20204%2C404%20C204%2C626.570754%20384.429246%2C807%20607%2C807%20Z%20M423.121094%2C116.945312%20C439.794354%2C116.945312%20453.902286%2C122.780866%20465.445312%2C134.452148%20C476.988339%2C146.123431%20482.759766%2C160.167236%20482.759766%2C176.583984%20C482.759766%2C193.000733%20476.924212%2C206.980411%20465.25293%2C218.523438%20C453.581647%2C230.066464%20439.537843%2C235.837891%20423.121094%2C235.837891%20C406.704345%2C235.837891%20392.724667%2C230.066464%20381.181641%2C218.523438%20C369.638614%2C206.980411%20363.867188%2C193.000733%20363.867188%2C176.583984%20C363.867188%2C160.167236%20369.638614%2C146.123431%20381.181641%2C134.452148%20C392.724667%2C122.780866%20406.704345%2C116.945312%20423.121094%2C116.945312%20Z%20M476.988281%2C291.244141%20L476.988281%2C576.355469%20C476.988281%2C601.750127%20479.938122%2C617.974249%20485.837891%2C625.02832%20C491.73766%2C632.082392%20503.280513%2C636.122391%20520.466797%2C637.148438%20L520.466797%2C651%20L326.160156%2C651%20L326.160156%2C637.148438%20C342.063882%2C636.635414%20353.863243%2C632.018273%20361.558594%2C623.296875%20C366.688828%2C617.397106%20369.253906%2C601.750127%20369.253906%2C576.355469%20L369.253906%2C366.273438%20C369.253906%2C340.878779%20366.304066%2C324.654658%20360.404297%2C317.600586%20C354.504528%2C310.546514%20343.089928%2C306.506516%20326.160156%2C305.480469%20L326.160156%2C291.244141%20L476.988281%2C291.244141%20Z%20M754.019531%2C597.902344%20C710.156031%2C636.63561%20670.782075%2C656.001953%20635.896484%2C656.001953%20C615.375548%2C656.001953%20598.317776%2C649.268622%20584.722656%2C635.801758%20C571.127536%2C622.334894%20564.330078%2C605.469502%20564.330078%2C585.205078%20C564.330078%2C557.758326%20576.129439%2C533.069446%20599.728516%2C511.137695%20C623.327592%2C489.205945%20674.757416%2C460.028177%20754.019531%2C423.603516%20L754.019531%2C387.435547%20C754.019531%2C360.245307%20752.544611%2C343.123408%20749.594727%2C336.069336%20C746.644842%2C329.015264%20741.065796%2C322.859076%20732.857422%2C317.600586%20C724.649048%2C312.342096%20715.414765%2C309.712891%20705.154297%2C309.712891%20C688.481036%2C309.712891%20674.757866%2C313.432254%20663.984375%2C320.871094%20C657.315071%2C325.488304%20653.980469%2C330.874969%20653.980469%2C337.03125%20C653.980469%2C342.417996%20657.571579%2C349.0872%20664.753906%2C357.039062%20C674.501351%2C368.069066%20679.375%2C378.714141%20679.375%2C388.974609%20C679.375%2C401.543683%20674.693732%2C412.252885%20665.331055%2C421.102539%20C655.968378%2C429.952193%20643.720128%2C434.376953%20628.585938%2C434.376953%20C612.4257%2C434.376953%20598.894911%2C429.503304%20587.993164%2C419.755859%20C577.091417%2C410.008415%20571.640625%2C398.593815%20571.640625%2C385.511719%20C571.640625%2C367.042876%20578.951099%2C349.407962%20593.572266%2C332.606445%20C608.193432%2C315.804929%20628.585807%2C302.915409%20654.75%2C293.9375%20C680.914193%2C284.959591%20708.104026%2C280.470703%20736.320312%2C280.470703%20C770.436368%2C280.470703%20797.43382%2C287.71705%20817.313477%2C302.209961%20C837.193133%2C316.702872%20850.082653%2C332.413978%20855.982422%2C349.34375%20C859.573586%2C360.117241%20861.369141%2C384.870249%20861.369141%2C423.603516%20L861.369141%2C563.273438%20C861.369141%2C579.690186%20862.01041%2C590.014627%20863.292969%2C594.24707%20C864.575527%2C598.479513%20866.499336%2C601.621735%20869.064453%2C603.673828%20C871.62957%2C605.725922%20874.57941%2C606.751953%20877.914062%2C606.751953%20C884.583367%2C606.751953%20891.380825%2C602.006558%20898.306641%2C592.515625%20L909.849609%2C601.75%20C897.024024%2C620.731866%20883.749743%2C634.519163%20870.026367%2C643.112305%20C856.302991%2C651.705447%20840.720139%2C656.001953%20823.277344%2C656.001953%20C802.756408%2C656.001953%20786.724667%2C651.192431%20775.181641%2C641.573242%20C763.638614%2C631.954053%20756.584648%2C617.397233%20754.019531%2C597.902344%20Z%20M754.019531%2C569.814453%20L754.019531%2C449.382812%20C722.981616%2C467.595143%20699.895909%2C487.08974%20684.761719%2C507.867188%20C674.757762%2C521.718819%20669.755859%2C535.698497%20669.755859%2C549.806641%20C669.755859%2C561.606179%20673.988239%2C571.994747%20682.453125%2C580.972656%20C688.865917%2C587.898472%20697.843692%2C591.361328%20709.386719%2C591.361328%20C722.212304%2C591.361328%20737.089759%2C584.179108%20754.019531%2C569.814453%20Z%22%20id%3D%22Oval-1%22%20fill%3D%22%23000066%22%20sketch%3Atype%3D%22MSShapeGroup%22%3E%3C%2Fpath%3E%0A%20%20%20%20%3C%2Fg%3E%0A%3C%2Fsvg%3E)
%22%3E%3C!--arctan(-3%2F2)--%3E%0A%3Cg%20id%3D%22b2%22%3E%3Cpath%20id%3D%22b%22%20d%3D%22M-6-25H6M-6-22H6M-6-19H6%22%20stroke%3D%22%23000%22%20stroke-width%3D%222%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23b%22%20y%3D%2244%22%2F%3E%3C%2Fg%3E%0A%3Cpath%20stroke%3D%22%23fff%22%20stroke-width%3D%221%22%20d%3D%22M0%2C17v10%22%2F%3E%0A%3Ccircle%20fill%3D%22%23c60c30%22%20r%3D%2212%22%2F%3E%0A%3Cpath%20fill%3D%22%23003478%22%20d%3D%22M0-12A6%2C6%200%200%200%200%2C0A6%2C6%200%200%201%200%2C12A12%2C12%200%200%2C1%200-12Z%22%2F%3E%3C%2Fg%3E%0A%3Cg%20transform%3D%22rotate(-123.6900675)%22%3E%3Cuse%20xlink%3Ahref%3D%22%23b2%22%2F%3E%0A%3Cpath%20stroke%3D%22%23fff%22%20stroke-width%3D%221%22%20d%3D%22M0-23.5v3M0%2C17v3.5M0%2C23.5v3%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E)
%22%2F%3E%0A%3C%2Fg%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23castle%22%20x%3D%2245.7138%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23castle3%22%20transform%3D%22matrix(-1%2C0%2C0%2C1%2C479.79195%2C0)%22%2F%3E%0A%3Cg%20id%3D%22quina%22%20fill%3D%22%23fff%22%3E%0A%3Cpath%20fill%3D%22%23039%22%20d%3D%22m232.636%2C202.406v0.005c0%2C2.2119%2C0.84927%2C4.2272%2C2.2118%2C5.6894%2C1.3652%2C1.4667%2C3.2454%2C2.3777%2C5.302%2C2.3777%2C2.0672%2C0%2C3.9439-0.90487%2C5.3029-2.3654%2C1.3581-1.4587%2C2.2021-3.47219%2C2.2021-5.693v-10.768l-14.992-0.0123-0.0273%2C10.766%22%2F%3E%0A%3Ccircle%20cx%3D%22236.074%22%20cy%3D%22195.735%22%20r%3D%221.486%22%2F%3E%0A%3Ccircle%20cx%3D%22244.392%22%20cy%3D%22195.742%22%20r%3D%221.486%22%2F%3E%0A%3Ccircle%20cx%3D%22240.225%22%20cy%3D%22199.735%22%20r%3D%221.486%22%2F%3E%0A%3Ccircle%20cx%3D%22236.074%22%20cy%3D%22203.916%22%20r%3D%221.486%22%2F%3E%0A%3Ccircle%20cx%3D%22244.383%22%20cy%3D%22203.905%22%20r%3D%221.486%22%2F%3E%0A%3C%2Fg%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23quina%22%20y%3D%22-26.016%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23quina%22%20x%3D%22-20.799%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23quina%22%20x%3D%2220.745%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23quina%22%20y%3D%2225.784%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fsvg%3E)
%22%2F%3E%0A%3C%2Fdefs%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22scale(3)%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22translate(5%2C-3)%20rotate(-120.963756)%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22translate(7%2C-1)%20rotate(-98.130102)%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22translate(7%2C2)%20rotate(-74.054604)%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22translate(5%2C4)%20rotate(-51.3401917)%22%2F%3E%0A%3C%2Fsvg%3E%0A)
%22%2F%3E%0A%20%20%20%3Cuse%20xlink%3Ahref%3D%22%23four_rays%22%20transform%3D%22rotate(60)%22%2F%3E%0A%20%20%20%3Ccircle%20r%3D%2217%22%20fill%3D%22%23000095%22%2F%3E%0A%20%20%20%3Ccircle%20r%3D%2215%22%20fill%3D%22%23fff%22%2F%3E%0A%3C%2Fsvg%3E)
Plugins de idioma
La interfaz de usuario de TiddlyWiki está disponible en más de 20 idiomas. Puedes instalar cualquiera de ellos desde el panel de control, en la pestaña Plugins.
Aprendiendo a traducir TiddlyWiki a tu idioma puedes contribuir a ampliar la librería.
Ediciones en otros idiomas
Existen ediciones precompiladas en algunos idiomas, que contienen documentación adicional:
| purpose | select the last N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | the last N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]last[]]
[list[Days of the Week]last[5]]
[tag[Concepts]!sort[title]last[3]]
Las últimas noticias, artículos, recursos y ejemplos.
"Font Awesome 5 Free SVGs for TiddlyWiki" by morosanuae
The Font Awesome 5 Free SVG images collection converted to tiddlers that you can easily import (drag'n'drop) in your wiki.
TiddlyDrive Add-on for Google Drive by Joshua Stubbs
An add-on for Google Drive that allows TiddlyWiki files stored there to be opened and saved directly
To find out how to add it to your account, go to the project's info page: https://lordratte.gitlab.io/tiddlydrive/#installation-guide
I made an app that lets one edit TiddlyWiki files saved in your Google drive and then saving them back automagically. The page is here https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo but I think you need to add it from the Google Drive web interface.
I even added an optional ability to save with ctrl + s hotkeys.
Joshua's launch post
Json Mangler plugin by Joshua Fontany
Extend tiddlywiki to parse complex ("nested") json data tiddlers.
Json Mangler introduces a new path syntax for indexes of json data tiddlers , and includes many supporting tools, filters, widgets, etc.
Example Wiki: https://joshuafontany.github.io/TW5-JsonManglerPlugin/
Source: https://github.com/joshuafontany/TW5-JsonManglerPlugin
Disqus comments plugin by bimlas
Use this plugin to give your visitors the opportunity to comment on your tiddlers without changing the wiki itself.
Disqus is a networked community platform used by hundreds of thousands of sites all over the web. With Disqus, your website gains a feature-rich comment system complete with social network integration, advanced administration and moderation options, and other extensive community functions.
Locator plugin by bimlas
For those who use many tags or store many different topics in a common wiki the Locator plugin is a table of contents widget and an enhanced search engine that gives you the opportunity to filter results by related tags. Unlike table of contents, standard search and list of tags, this plugin offers these features in an organic, collaborative way.
Kin filter operator by bimlas
The purpose of the kin operator with examples:
- Finds related tags, related tiddlers in any depth
- Finds out where base tiddler originates and what other elements originate from it
- Finds the ancestors and successors of a family member
- Finds the "leaves" of the branch of the base tiddler in a tree-like structure (where the base tiddler is a leaf)
- Finds the super- and subsets / groups of a mathematical set (where the base tiddler is a set)
"TiddlyWiki5^2 documenting while learning TiddlyWiki5" by Iannis Zannos
A wealth of hints, tips and notes about using TiddlyWiki on Node.js:
TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline.
The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web.
Also very cool is the treatment of tags as menus everywhere.
http://larigot.avarts.ionio.gr/users/iani/wikis/tw5square.html
Also available on GitHub (download and save index.html and open it in your browser).
Code styles and auto format settings for IDEs
Implementation of TiddlyWiki Coding Style Guidelines for different IDEs.
Generalmente, todo el contenido de todos los tiddlers se incrusta en el archivo HTML principal. Lazy loading o Carga diferida es la técnica por la que sólo se incrustan los metadatos del tiddler (es decir, todos los campos menos text), que se pide al servidor cuando se necesita. (Más información, aquí)
Puede aplicarse carga diferida en dos configuraciones:
- En Node.js se puede aplicar a los tiddlers de imágenes o a todos los tiddlers excepto los de sistema
- En TiddlyWiki in the Sky for TiddlyWeb, se puede aplicar a todos los tiddlers
Carga diferida en Node.js
Para iniciar TiddlyWiki en carga diferida de imágenes, utiliza este comando:
tiddlywiki --server 8080 $:/core/save/lazy-imagespara aplicar la carga diferida a todos los tiddlers salvo los de sistema, utiliza este este otro:
tiddlywiki --server 8080 $:/core/save/lazy-allCarga diferida en TiddlyWeb
En la configuración actual, la carga diferida se aplica por defecto.
A mapping plugin based on Leaflet library. Allows you to create maps based upon geographical data contained in tiddlers.
http://sycom.github.io/TiddlyWiki-Plugins/#Leaflet%20plugin
The leaflet plugin is a (working) attempt to integrate the leaflet library in TiddlyWiki in order to display geographical purpose tiddlers.
For now
<$leafmap>widget displays an interactive map. Select size, location and zoom, clustering distance, and background. You can display data : geojson, point(s), polygon(s) and/or polyline(s) directly or calling GeoTiddler(s). Tiddler can be called individually, by list or with a filter.Have a look at demo page on the web.
Aprende a usar TiddlyWiki:
- Videos
- TiddlyWiki en Dropbox
- Compartir Tiddlers
- Importar tiddlers
- Subhistorias
- Edición con Emacs
- Galería de imágenes
- Texto curvo con SVG
- Administración de tareas
- Botón "Seguir en Twitter"
- Filosofía
- Políticas de estilo
- TaskManagementExample (Draggable)
- TaskManagementExampleDraggableTemplate
- FIltros: Introducción
- Concatenating text and variables using macro substitution
- Edición con Vim
- Formatting List Results as Tables with CSS - Specified Columns Methods
- Formatting List Results as Tables with CSS - Variable Column Method
- Formatting List Results as Tables (no CSS)
- Banner para contribuciones en GitHub
- Estilos CSS con etiquetas
- How to change the sort order of sub-branches in a TOC macro
- How to create keyboard shortcuts
- How to Customize TiddlyDesktop
- How to embed PDF and other documents
- Exportación de tiddlers
- How to hide the author's and other fields with CSS
- Banner de fecha de última modificación
- How to widen tiddlers (aka storyriver)
- Añadir pestañas a la barra lateral
- How to turn off camel case linking
- Simple ways to write protect tiddlers
- Introduction to Lists
MIra también la documentación completa, que incluye nociones avanzadas de WikiText, macros, widgets, filtros... etc.
| purpose | returns the lengths of each item in the list |
|---|---|
| input | a selection of titles |
| output | replaces each input title with its length as an integer |
New in: 5.1.20
TiddlyWiki is published under a permissive BSD 3-Clause License stored in the shadow tiddler $:/core/copyright.txt:
TiddlyWiki created by Jeremy Ruston, (jeremy [at] jermolene [dot] com)
Copyright (c) 2004-2007, Jeremy Ruston
Copyright (c) 2007-2018, UnaMesa Association
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.In layman's terms, the license says that you can take TiddlyWiki and do anything you want with it without any license fee payment or other legal obligation to the creators of TiddlyWiki or anyone else. The quid pro quo is that there is no warranty or guarantee with open source projects like TiddlyWiki. You can't sue the contributors to TiddlyWiki for any loss or damage due to the use of TiddlyWiki: even if your data is lost due to a tragic chain of circumstances that involves TiddlyWiki.
You are respectfully requested that to make an attribution to the project, but there's no obligation to do so.
For the avoidance of doubt, any information that you choose to store within your own copy of TiddlyWiki remains yours; using TiddlyWiki to publish content doesn't change whatever rights you may have to that content.
| purpose | select the first or last N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 0 |
| output | the first N input titles |
! output | the last N input titles |
limit[N] and !limit[N] are synonyms for first[N] and last[N] respectively.
[sort[modified]!limit[20]]
[has[created]sort[created]limit[10]]
The lingo macro relates to the translation of TiddlyWiki's user interface into other languages. It returns a piece of text in the user's currently selected language.
Translatable text is supplied by language plugins containing tiddlers with specific titles that start with $:/language/.
Parameters
- title
- The title of the shadow tiddler that contains the text. The prefix
$:/language/is added automatically
This example shows the text used as the basis for the title of a newly created tiddler:
<<lingo DefaultNewTiddlerTitle>>This example shows the name of the eighth month of the year, for use in formatting dates:
<<lingo Date/Long/Month/8>>Introduction
The link catcher widget traps WidgetMessage: tm-navigate dispatched within its child content by performing any or all of these actions:
- sending a different widget message
- setting a tiddler to the title of the navigated tiddler
- setting a tiddler to a specified value
- performing a series of ActionWidgets
Content and Attributes
The content of the <$linkcatcher> widget is displayed normally.
| Attribute | Description |
|---|---|
| to | Optional title of the tiddler to be set to the title of the navigated tiddler |
| message | Optional identifier for a widget message to be sent when a navigation is caught |
| set | Optional title of the tiddler to be set to a specified value when navigation occurs |
| setTo | Value to be assigned by the set attribute |
| actions | Actions to be performed when a link is caught. Within the action string, the variable "navigateTo" contains the title of the tiddler being navigated |
A key capability of WikiText is the ability to make links to other tiddlers or to external websites.
Manual Links
Link to a tiddler by title:
[[Tiddler Title]]To link to a tiddler and specify the text of the link:
[[Displayed Link Title|Tiddler Title]]You can also create a link from the editor toolbar. Click link (), and search and select a tiddler.
CamelCase Links
For tiddler titles that match the CamelCase rules, just typing the title without double square brackets will automatically create a link.
You can suppress a link from being recognised by preceding it with ~. For example:
* ~HelloThere is not a link
* ~http://google.com/ is not a linkTiene este aspecto:
- HelloThere is not a link
- http://google.com/ is not a link
... y su código HTML es:
<ul><li>HelloThere is not a link</li><li>http://google.com/ is not a link</li></ul>
External Links
To link to an external resource such as a website or a file, type its full URL, including the URI scheme such as a protocol (e.g. http://, file://) or mailto:
https://tiddlywiki.com/
[[TW5|https://tiddlywiki.com/]]
[[Mail me|mailto:me@where.net]]
[[Open file|file:///c:/users/me/index.html]]For this syntax to work, the URL has to be recognisable as a URL. Otherwise, it is treated as a tiddler title. As a result, in case you want to link to a resource locatable using a relative path, use the extended syntax:
[ext[Open file|index.html]]
[ext[Open file|./index.html]]
[ext[Open file|../README.md]]
[ext[Open file|c:\users\me\index.html]]The extended syntax still works with full URLs, although in that case it is not necessary:
[ext[https://tiddlywiki.com]]
[ext[TW5|https://tiddlywiki.com]]
[ext[Mail me|mailto:me@where.net]]
[ext[Open file|file:///c:/users/me/index.html]]You can also use the extended syntax to force an external link:
[ext[Donate|bitcoin:1aabbdd....?amount=0.001]]Customising Tiddler Links
See the LinkWidget for details of the underlying widget used to implement tiddler links, including macros that can be used to customise its behaviour.
| purpose | find the titles linked to by each input title |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | the titles to which the input tiddlers contain hard links |
Each input title is processed in turn. The corresponding tiddler's list of links is generated, in the order in which they appear in the tiddler's text, and dominantly appended to the operator's overall output.
[[HelloThere]links[]]
Here are some hard links:
The link widget generates links to tiddlers. (Use the HTML <a> element to generate external links).
Content and Attributes
The content of the link widget is rendered within the <a> tag representing the link. If the content is empty then the title of the target tiddler is rendered as the default.
For example, <$link to="HelloThere"/> is equivalent to <$link to="HelloThere">HelloThere</$link> and <$link/> is equivalent to <$link to=<<currentTiddler>>><$view field="title"/></$link>.
| Attribute | Description |
|---|---|
| to | The title of the target tiddler for the link (defaults to the current tiddler) |
| aria-label | Optional accessibility label |
| tooltip | Optional tooltip WikiText |
| tabindex | Optional numeric tabindex |
| draggable | "yes" to enable the link to be draggable (defaults to "yes") |
| tag | Optional tag to override the default "a" element |
| class | Optional CSS classes in addition to the default classes (see below) |
| overrideClass | New in: 5.1.16 Optional CSS classes instead of the default classes |
The draggable functionality is equivalent to using the DraggableWidget with the tiddler attribute set to the link target.
The default value of the tooltip attribute is supplied by the tv-wikilink-tooltip variable.
This means that you can control the text of a link tooltip in several ways:
<$link to="HelloThere" tooltip="Custom tooltip">Link 1</$link>
<$set name="tv-wikilink-tooltip" value="I'm a link to {{!!title}}">
<$link to="HelloThere">Link 2</$link>
</$set>
Renders as:
Note that the tooltip is rendered with the current tiddler set to the target of the link.
A useful convention is to set the tooltip like this:
\define tv-wikilink-tooltip()
<$transclude field="tooltip"><$transclude field="title"/></$transclude>
\endThis causes the tooltip to be the tooltip field of the target tiddler. If the field isn't present, then the title is used instead.
CSS Classes
The link widget automatically determines and applies the following classes to links:
tc-tiddlylink- applied to all linkstc-tiddlylink-external- applied to external, non-tiddler linkstc-tiddlylink-internal- applied to tiddler linkstc-tiddlylink-missing- applied to tiddler links where the target tiddler doesn't existtc-tiddlylink-resolves- applied to tiddler links when the target tiddler does exist
Use the class attribute to specify additional css classes, or overrideClass to apply only that but not the above defaults, e.g. when used in a LinkCatcherWidget:
*<$link class="example">Here</$link> the `example` class is added.
*<$link overrideClass="example">Here</$link> only the `example` class applies.
*<$link overrideClass="">Here</$link> no class is set.Este es su aspecto:
href generation
The following process is used to generate the href attribute of the generated HTML <a> element:
- If
tv-get-export-linkis defined it is invoked to convert the target tiddler title to thehrefvalue- In practice, only a JavaScript macro can be used
- New in: 5.1.15 If
tv-filter-export-linkis defined it is interpreted as a filter that converts the target tiddler title to thehrefvalue - If
tv-wikilink-templateis defined it is treated as a specialised macro body that can perform limited conversion of the target tiddler title to thehrefvalue - Otherwise, the target tiddler title is URI encoded to create the
href
Configuration variables
| purpose | select titles via a list field |
|---|---|
| input | ignored |
! input | a selection of titles |
| parameter | R = a reference to a field or property of a particular tiddler |
| output | the titles stored as a title list at R |
! output | those input titles that are not mentioned at R |
R can reference either a field or a property. See TextReference for the syntax.
- If neither is specified, the
listfield is used by default. So[list[T]]outputs the titles listed in thelistof tiddler T. - If
Rconsists of only a field or a property, the tiddler part of the reference defaults to the current tiddler. So[list[!!tags]]outputs the titles listed in thetagsfield of the current tiddler.
These examples make use of the Days of the Week tiddler.
[list[HelloThere]]
[list[Days of the Week!!short]]
The list-links macro returns a formatted list of links to a selection of tiddlers.
If a tiddler has a caption field, this is shown instead of the tiddler's title. If the caption field is empty, a blank entry is shown.
Note: Each first step of a filter run not given any input titles receives the output of [all[tiddlers]] as its input. This means all the existing non-shadow tiddlers.
Parameters
- filter
- A filter selecting which tiddlers to include
- type
- An HTML element to use for the overall list element, defaulting to
ul - subtype
- An HTML element to use for each item in the list, defaulting to
li - class
- A CSS class for the overall list element
- emptyMessage
- Optional wikitext to display if there are no tiddlers with the specified tag
This example lists all the tiddlers whose titles start with J:
<<list-links filter:"[prefix[J]]">>This example lists the documentation tiddlers for the core macros, each of which has a caption field:
<<list-links filter:"[tag[Core Macros]]">>The list-links-draggable macro renders the ListField of a tiddler as a list of links that can be reordered via drag and drop.
Parameters
- tiddler
- The title of the tiddler containing the list
- field
- The name of the field containing the list (defaults to
list) - type
- The element tag to use for the list wrapper (defaults to
ul) - subtype
- The element tag to use for the list items (defaults to
li) - class
- Optional space separated classes to add to the wrapper element
- itemTemplate
- Optional title of a tiddler to use as the template for rendering list items
If the itemTemplate parameter is not provided then the list items are rendered as simple links. Within the itemTemplate, the currentTiddler Variable refers to the current list item.
The list-tagged-draggable macro renders the tiddlers with a particular tag as a list of links that can be reordered via drag and drop.
Parameters
- tag
- The title of the tag
- subFilter
- An optional subfilter to filter out unwanted items (eg
!tag[done]) - itemTemplate
- Optional title of a tiddler to use as the template for rendering list items
- emptyMessage
- Optional wikitext to display if there are no tiddlers with the specified tag
Note that the ordering is accomplished by assigning a new list to the list field of the tag tiddler. Any list-before or list-after fields on any of the other tiddlers carrying the tag are also removed to ensure the list field is respected.
If the itemTemplate parameter is not provided then the list items are rendered as simple links. Within the itemTemplate, the currentTiddler Variable refers to the current list item.
| purpose | find the titles that list the input titles |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to list |
| output | the titles in which field F mentions any of the input titles |
F is assumed to be a title list.
Each input title is processed in turn. A list of tiddlers whose F field mentions it is generated (in no particular order) and dominantly appended to the operator's overall output.
New in: 5.1.18 See WebServer for details of TiddlyWiki's web server functionality.
Serves a wiki over HTTP.
The listen command uses NamedCommandParameters:
--listen [<name>=<value>]...All parameters are optional with safe defaults, and can be specified in any order. The recognised parameters are:
- host - optional hostname to serve from (defaults to "127.0.0.1" aka "localhost")
- path-prefix - optional prefix for paths
- port - port number on which to listen; non-numeric values are interpreted as a system environment variable from which the port number is extracted (defaults to "8080")
- credentials - pathname of credentials CSV file (relative to wiki folder)
- anon-username - the username for signing edits for anonymous users
- username - optional username for basic authentication
- password - optional password for basic authentication
- authenticated-user-header - optional name of header to be used for trusted authentication
- readers - comma separated list of principals allowed to read from this wiki
- writers - comma separated list of principals allowed to write to this wiki
- csrf-disable - set to "yes" to disable CSRF checks (defaults to "no")
- root-tiddler - the tiddler to serve at the root (defaults to "$:/core/save/all")
- root-render-type - the content type to which the root tiddler should be rendered (defaults to "text/plain")
- root-serve-type - the content type with which the root tiddler should be served (defaults to "text/html")
- tls-cert - pathname of TLS certificate file (relative to wiki folder)
- tls-key - pathname of TLS key file (relative to wiki folder)
- debug-level - optional debug level; set to "debug" to view request details (defaults to "none")
- gzip - set to "yes" to enable gzip compression for some http endpoints (defaults to "no")
For information on opening up your instance to the entire local network, and possible security concerns, see the WebServer tiddler at TiddlyWiki.com.
El campo list es una característica opcional que se usa para estructurar contenido. Su valor es una lista y puede usarse de varias maneras:
- El campo
listde un tiddler que se usa como etiqueta determina el orden en que se presentan los tiddlers que llevan esa etiqueta. Más detalles en Etiquetas - El filtro
listselecciona entradas de una lista - El filtro
listedmuestra qué tiddlers incluyen un tiddler (o selección de varios tiddlers) como entradas de lista. - El widget Navegador manipula un StoryList que contiene un campo
listde los tiddlers que se muestran en la columna principal.
Bulleted Lists
You can create bulleted (unordered) lists with * characters ():
* First list item
* Second list item
** A subitem
* Third list item
Tiene este aspecto:
- First list item
- Second list item
- A subitem
- Third list item
... y su código HTML es:
<ul><li>First list item</li><li>Second list item<ul><li>A subitem</li></ul></li><li>Third list item</li></ul>
Numbered Lists
Numbered (ordered) lists use # instead of * ():
- First item
- Second item
- Third item
You can also mix ordered and unordered list items:
* To do today
*# Eat
* To get someone else to do
*# This
*# That
*## And the other
Tiene este aspecto:
- To do today
- Eat
- To get someone else to do
- This
- That
- And the other
... y su código HTML es:
<ul><li>To do today<ol><li>Eat</li></ol></li><li>To get someone else to do<ol><li>This</li><li>That<ol><li>And the other</li></ol></li></ol></li></ul>
Here's an example the other way around, with numbers as the first level:
# To do today
#* Eat
# To get someone else to do
#* This
#* That
#** And the other
Tiene este aspecto:
- To do today
- Eat
- To get someone else to do
- This
- That
- And the other
... y su código HTML es:
<ol><li>To do today<ul><li>Eat</li></ul></li><li>To get someone else to do<ul><li>This</li><li>That<ul><li>And the other</li></ul></li></ul></li></ol>
CSS Classes
You can also assign a CSS class to an individual member of a list with this notation:
* List One
*.MyClass List Two
* List Three
Tiene este aspecto:
- List One
- List Two
- List Three
... y su código HTML es:
<ul><li>List One</li><li class="MyClass">List Two</li><li>List Three</li></ul>
Mixing Lists and Block Quotes
Note that Block Quotes in WikiText can be mixed with lists. For example:
* List One
** List Two
**> A quote
**> Another quote
* List Three
Tiene este aspecto:
- List One
- List Two
A quote
Another quote
- List Two
- List Three
... y su código HTML es:
<ul><li>List One<ul><li>List Two<blockquote><p>A quote</p><p>Another quote</p></blockquote></li></ul></li><li>List Three</li></ul>
Paragraphs in Lists
Entries in the list are delimited with a linebreak, making it impossible to include linebreaks within a list entry. There are a couple of workarounds.
First, you can transclude paragraph content from another tiddler. For example:
* First entry
* <$transclude tiddler="MyTiddler" mode="block"/>
* Third entrySecondly, you can use an HTML "div" element to contain the multiline content. For example:
# Step 1
# Step 2
# Step 3<div>
Here is the first of several paragraphs. Note that the double linebreak preceding this paragraph is significant.
And here is the second of several paragraphs.
</div>
# Step 4
# Step 5
# Step 6Introducción
El ListWidget muestra una secuencia de tiddlers que coinciden con una expresión de filtro. Sirve para:
- Mostrar listas particulares de enlaces, como en la barra lateral de TiddlyWiki5
- Confeccionar listas a medida, como "todos aquellos tiddlers con etiqueta
tarea, no etiquetados comohecha" - Hacer una lista de las etiquetas aplicadas a un tiddler
- Manejar el StoryRIver principal
Los tiddlers se muestran por transclusión, uno a uno, en una plantilla. Hay diversas maneras de especificar la plantilla, así como de controlar el comportamiento de la lista.
Ejemplos
lista plana: lista sin formato
<$list filter="[tag[Contents]sort[title]]"/>Se muestra como:
custom item output
<$list filter="[tag[Contents]sort[title]]">
<<currentTiddler>>
{{||$:/core/ui/ViewTemplate/subtitle}}
</$list>Se muestra como
First
Fourth Second Third
custom template output
<$list filter="[tag[Contents]sort[title]]" template="$:/core/ui/ViewTemplate/subtitle"/>Se muestra como:
Listas anidadas
En listas anidadas se explica cómo generar listas anidadas con ListWidget.
Contenido y atributos
El contenido del widget <$list> es una plantilla opcional usada para representar cada tiddler de la lista. Alternativamente, puede especificarse la plantilla como título de un tiddler en el atributo template. Como alternativa, la plantilla por defecto sólo muestra el título del tiddler.
| Atributo | Descripción |
|---|---|
| filter | Tiddler de filtro para mostrar |
| template | Título de la plantilla de transclusión para cada tiddler de la lista. Si no es especifica ninguna, es el propio cuerpo de ListWidget el que sirve como plantilla. The title of a template tiddler for transcluding each tiddler in the list. Sin cuerpo, sólo se muestra un enlace al tiddler. |
| editTemplate | Plantilla alternativa para el uso de borradores en modo edición |
| variable | Nombre de la variable que guarda el título de cada tiddler. Por defecto, currentTiddler |
| emptyMessage | Mensaje que se muestra si la lista está vacía |
| storyview | nombre optativo del módulo responsable de animar/procesar la lista |
| history | Título del tiddler que contiene el historial de navegación |
Modo edición
El widget <$list>puede procesar tiddlers en borrador con una plantilla diferente. Consultar borradores
Atributo storyview
El atributo storyview especifica el nombre de de un módulo optativo que puede animar los cambios realizados en la lista (incluso la navegación). El núcleo incluye por defecto los siguientes módulos:
- classic: muestra la lista como una secuencia ordenada de tiddlers
- zooming: muestra sólo el tiddler actual con una animación de zoom al navegar entre tiddlers
- pop: muestra los tiddlers de uno en uno, con efecto de tiddler emergente.
Para que la animación de storyview sea correcta, cada entrada de la lista debe ser un único bloque DOM.
Histórico y navegación
El atributo opcional history especifica el nombre del tiddler usado para rastrear el actual, con el fin de presentar el histórico de navegación. Cuando el histórico cambia, le pide a la ListView que procese la navegación al siguiente tiddler. Véase Histórico para mayor información.
Carga tiddlers de archivos de tipo TiddlyWiki 2.x.x.(.html), .tiddler, .tid, .json u otros
--load <filepath>Para cargar tiddlers de un TiddlyWiki encriptado, primero debes especificar la contraseña con el comando PasswordCommand. Por ejemplo:
tiddlywiki ./MyWiki --password pa55w0rd --load my_encrypted_wiki.htmlTen en cuenta que TiddlyWiki no carga complementos o extensiones anteriores a los ya cargados.
For those who use many tags or store many different topics in a common wiki the Locator plugin is a table of contents widget and an enhanced search engine that gives you the opportunity to filter results by related tags. Unlike table of contents, standard search and list of tags, this plugin offers these features in an organic, collaborative way.
| purpose | applies a prefix to each input title to yield the title of a tiddler from which the final value is retrieved |
|---|---|
| input | a selection of titles |
| suffix | D = the default value to be used for missing lookups |
| parameter | P = prefix applied to input titles to yield title of lookup tiddler from which value is retrieved |
| output | the lookup values corresponding to each input title |
New in: 5.1.15
The action of this operator is as follows:
- Apply the specified prefix to each input tiddler title, yielding a new list of tiddler titles
- Transclude the value of each of those tiddlers
- Substitute the default value for missing or empty tiddlers
- Return the list of values
[all[shadows+tiddlers]tag[$:/tags/PageControls]lookup[$:/config/PageControlButtons/Visibility/]]
[all[shadows+tiddlers]tag[$:/tags/PageControls]lookup:show[$:/config/PageControlButtons/Visibility/]]
| purpose | returns each item in the list as lowercase |
|---|---|
| input | a selection of titles |
| output | the input titles with each uppercase letter replaced by the equivalent lowercase letter |
- What follows is a formal presentation of the syntax of the WikiText syntax for macro calls, using railroad diagrams. A simpler overview is also available.
space denotes a sequence of whitespace characters.
The macro's name is a sequence of non-whitespace characters other than ( or >.
Each individual param-value has the following syntax:
The param-name is a sequence of letters (A–Z, a–z), digits (0–9), hyphens (-) and underscores (_).
The value is specified as follows:
To call a macro, place <<double angle brackets>> around the name and any parameter values.
By default, parameters are listed in the same order as in the macro's definition. A parameter can be labelled with its name, either for clarity or to modify the order.
If no value is specified for a parameter, the default value given for that parameter in the macro's definition is used instead. (If no default value was defined, the parameter is simply blank.)
Each parameter value can be enclosed in 'single quotes', "double quotes", """triple double quotes""" or [[double square brackets]]. Triple double quotes allow a value to contain almost anything. If a value contains no spaces or single or double quotes, it requires no delimiters.
A more formal presentation of this syntax is also available.
The syntax is actually a shorthand for a $macrocall widget. The widget itself offers greater flexibility, including the ability to transclude parameter values or generate them via additional macros.
As macros are simply parameterised variables, a variable's value can be inserted using the same techniques.
Named vs.unnamed parameters
In the wikitext notation, using named parameters is always the safer choice compared to defining values only. Not naming parameters may have confusing side effects. For example, imagine the first parameter of some macro specifies a state tiddler while the second one is intended for a template tiddler. Should you accidentally forget to define the first parameter or are confused about the order, the next time your macro is run, which might even be triggered using the preview, your template tiddler may inadvertently be overriden with what was intended to be the state.
\define sayhi(name:"Bugs Bunny" address:"Rabbit Hole Hill")
Hi, I'm $name$ and I live in $address$.
\end
<<sayhi>><<sayhi Bugs>><<sayhi "Donald Duck" Disneyland>><<sayhi "Mickey Mouse" "Mouse House">><<sayhi name:'Minnie Mouse' address:[[Mouse House]]>><<sayhi address:"Quacky Towers" name:"Donald Duck">><<sayhi "Mickey Mouse" """"Mouse House",
Rodent's Lane,
Squeaksville,
Ratland""">>- What follows is a formal presentation of the syntax of the
\definepragma, using railroad diagrams. A simpler overview is also available.
space denotes a sequence of whitespace characters.
The macro's name is a sequence of non-whitespace characters other than ( or >.
The parameter declaration list (params) has the following syntax:
The parameter separator (sep) is any sequence of characters that does not match a param-name. Among other things, this includes commas, spaces and linefeeds.
A param-name is a sequence of letters (A–Z, a–z), digits (0–9), hyphens (-) and underscores (_).
Each individual param has the following syntax:
The optional default value of a parameter is specified as follows:
The rest of the definition has the following syntax:
lf denotes a linefeed.
The snippet is any sequence of characters that doesn't terminate the macro definition. That is to say, a single-line snippet cannot contain a linefeed, and a multi-line snippet cannot contain \end on a line of its own.
The snippet can contain placeholders with the following syntax:
A macro is defined using a \define pragma. Like any pragma, this can only appear at the start of a tiddler.
The first line of the definition specifies the macro name and any parameters. Each parameter has a name and, optionally, a default value that is used if no value is supplied on a particular call to the macro. The lines that follow contain the text of the macro text (i.e. the snippet represented by the macro name), until \end appears on a line by itself:
\define sayhi(name:"Bugs Bunny" address:"Rabbit Hole Hill")
Hi, I'm $name$ and I live in $address$.
\end
Alternatively, the entire definition can be presented on a single line without an \end marker:
\define sayhi(name:"Bugs Bunny") Hi, I'm $name$.A more formal presentation of this syntax is also available.
Accessing variables and parameters
Inside the macro there are several methods for accessing variables defined outside of the macro or parameters from the macro parameter list.
| syntax | description |
$...$ | Text substitution of a parameter defined in the macro parameters list |
<<__...__>> | Parameter-as-variable access to a parameter defined in the macro parameters list |
$(...)$ | Text substitution of a variable defined outside of the macro |
<<...>> | Access to a variable (or other macro) defined outside of the macro |
Placeholders $(...)$
The macro can contain placeholders for parameters. These consist of a parameter name between dollar signs, like $this$.
The macro can also contain placeholders for variables. These consist of a variable name (or macro name) between dollar signs and round brackets, like $(this)$.
The actual value of the parameter or variable is substituted for the placeholder whenever the macro is called:
\define say-hi-using-variables()
Hi, I'm $(name)$ and I live in $(address)$.
\end
\define name() Bugs
<$set name="address" value="Rabbit Hole Hill">
<<say-hi-using-variables>>
</$set>Parameters as Variables <<__...__>>
Parameters in a wikitext macro can be accessed as variables by using the syntax <<__...__>>, i.e the parameter name surrounded by double underscores. For example, the example above could also be expressed as:
\define sayhi(name:"Bugs Bunny") Hi, I'm <$text text=<<__name__>>/>.Accessing parameters as variables only works in macros that are wikified and not, for example, when a macro is used as an attribute value. The advantage of the technique is that it avoids the parameter value being substituted into the macro as a literal string, which in turn can help avoid issues with parameters that contain quotes.
For example, consider this macro. It invokes another macro using the single parameter as an argument for it:
\define film-quote(line) <$macrocall $name="anothermacro" actor="Bugs Bunny" line="""$line$"""/>The code above will fail if the macro is invoked with the argument containing triple double quotes (for example <<film-quote 'I quote thrice """ - see!?'>>). Using parameter variables offers a workaround:
\define film-quote(line) <$macrocall $name="anothermacro" actor="Bugs Bunny" line=<<__line__>>/>Scope
Macros are available to the tiddler that defines them, plus any tiddlers that it transcludes.
To make a macro available to all tiddlers, define it in a tiddler that has the tag $:/tags/Macro.
It is also possible to write a macro as a JavaScript module. JavaScript macros are available to all tiddlers, and offer the maximum flexibility.
A tiddler can manually import macro definitions from a selection of other tiddlers by using the $importvariables widget.
Introduction
The macro call widget provides an alternative syntax for invoking macros. The advantage of the widget form is that it allows macro parameters to be specified as widget attributes, thus allowing indirection and macro values to be set.
For example, a macro called italicise that takes a single parameter called text can be invoked in any of these ways:
<<italicise "Text to be made into italics">>
<<italicise text:"Text to be made into italics">>
<$macrocall $name="italicise" text="Text to be made into italics"/>
<$macrocall $name="italicise" text={{Title of tiddler containing text to be italicised}}/>
<$macrocall $name="italicise" text=<<textMaker "Another macro to generate the text to be italicised">>/>You can see several examples of the macro call widget within the core:
- Listing module information: $:/snippets/modules
- Listing field information: $:/snippets/allfields
- Generating
data:URIs: $:/themes/tiddlywiki/starlight/styles.tid
Content and Attributes
The content of the <$macrocall> widget is ignored.
| Attribute | Description |
|---|---|
| $name | Name of the macro to invoke |
| $type | ContentType with which the macro text should be parsed (defaults to text/vnd.tiddlywiki) |
| $output | ContentType for the output rendering (defaults to text/html, can also be text/plain) |
| parameters | Macro parameters specified as attributes |
A macro is a named snippet of text. WikiText can use the name as a shorthand way of transcluding the snippet. Such transclusions are known as macro calls, and each call can supply a different set of parameters that get substituted for special placeholders within the snippet.
For the syntax, see Macros in WikiText.
Most macros are in fact just parameterised variables.
They are created using the \define pragma. (Behind the scenes, this is transformed into a $set, i.e. macros and variables are two sides of the same coin.)
The snippet and its incoming parameter values are treated as simple strings of characters with no WikiText meaning, at least until the placeholders have been filled in and the macro call has returned. This means that a macro can assemble and return the complete syntax of a WikiText component, such as a link. (See Transclusion and Substitution for further discussion of this.)
The string returned by a macro call is parsed separately from any surrounding WikiText components. So a safe way to insert a special character sequence (such as [[ or <) without triggering its normal WikiText meaning is to wrap it in a macro.
Within a snippet itself, the only markup detected is $name$ (a placeholder for a macro parameter) and $(name)$ (a placeholder for a variable).
The dumpvariables macro lists all variables (including macros) that are available at that position in the widget tree.
An $importvariables widget can be used to copy macro definitions to another branch of the widget tree. TiddlyWiki uses this technique internally to implement global macros – namely any macros defined in tiddlers with the $:/tags/Macro tag.
For maximum flexibility, macros can also be written as JavaScript modules.
A similar effect to a parameterised macro call can be produced by setting variables around a transclusion.
TiddlyWiki's core has several macros built in.
The makedatauri macro takes a piece of text and an associated ContentType, and returns a corresponding data URI.
makedatauri is used to implement the datauri macro.
Parameters
- text
- The text to be converted to a data URI
- type
- The ContentType of the text
Construye el tiddler $:/UpgradeLibrary: librería de actualización
La librería de actualización tiene formato de plugin ordinario, de tipo library
Contiene copia de cada uno de los plugins, temas y paquetes de idioma disponibles en el repositorio de TiddlyWiki5
Este comando es, en principio, para uso interno del equipo de TiddlyWiki y sólo es de interés para aquellos usuarios que deseen compilar actualizaciones personalizadas
--makelibrary <title>El título por defecto del tiddler resultante es $:/UpgradeLibrary.
See the UpgradeMechanism for more details.
To get your own custom Journal button, start by cloning the New Journal button.
Then create your own config tiddlers, eg:
$:/config/myNewTiddler/Tagsand ...$:/config/myNewTiddler/Titleand ...$:/config/myNewTiddler/Text
Edit your custom button and "search and replace" the config tiddler names.
Change the following lines, near the end of the tiddler from
<$set name="journalTitleTemplate" value={{$:/config/NewJournal/Title}}>
<$set name="journalTags" value={{$:/config/NewJournal/Tags}}>
<$set name="journalText" value={{$:/config/NewJournal/Text}}>to
<$set name="journalTitleTemplate" value={{$:/config/myNewTiddler/Title}}>
<$set name="journalTags" value={{$:/config/myNewTiddler/Tags}}>
<$set name="journalText" value={{$:/config/myNewTiddler/Text}}>if you want to see your config tiddlers in the sidebar use:
<$set name="journalTitleTemplate" value={{config/myNewTiddler/Title}}>
<$set name="journalTags" value={{config/myNewTiddler/Tags}}>
<$set name="journalText" value={{config/myNewTiddler/Text}}>Este ejemplo muestra cómo usar SVG para mostrar transclusiones de texto a lo largo de un recorrido. Escribe algo en el cuadro de texto para probarlo.
Este es el código:
\define textOnPath(text)
$$$.svg
<svg width="100%" height="100%" viewBox="0 0 1000 300" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="background:white;">
<defs>
<path id="MyPath" d="M 100 200 C 200 100 300 0 400 100 C 500 200 600 300 700 200 C 800 100 900 100 900 100"/>
</defs>
<use xlink:href="#MyPath" fill="none" stroke="#ddd"/>
<text font-family="'Helvetica Neue', Helvetica, Arial, 'Lucida Grande', sans-serif" font-size="42.5">
<textPath xlink:href="#MyPath">
$text$
</textPath>
</text>
</svg>
$$$
\end- Sólo por si acaso, haz copia de seguridad de tu archivo HTML de TiddlyWiki
- Abre TiddlyWiki en el navegador
- En otra ventana del navegador, busca un enlace al plugin que quieres instalar en la página que lo contiene, p. ej., el enlace
$:/plugins/tiddlywiki/katexen https://tiddlywiki.com/plugins/tiddlywiki/katex/) - Arrastra el enlace hasta tu página. Aparecerá una banda de color verde en la parte superior de la pantalla.
- Suelta el enlace y aparecerá el tiddler de importación que te mostrará el título del tiddler que acabas de arrastrar. Confirma la importación con el botón.
- Guarda los cambios con el botón
- Recarga la página
- El plugin está instalado y listo para su uso
Para uso con el lenguaje de marcado Markdown, en lugar de WikiText.
Disponible https://tiddlywiki.com/plugins/tiddlywiki/markdown/
| purpose | returns each item in the list that matches the operand string |
|---|---|
| input | a selection of titles |
| suffix | the match operator uses a rich suffix, see below for details |
| parameter | the string to be matched |
| output | each item in the input list that matches the operand string (potentially including duplicates) |
! output | each item in the input list that does not match the operand string |
New in: 5.1.20
The match operator uses an extended syntax that permits multiple flags to be passed:
[match:<flag list>[<operand>]]- flag list: a comma delimited list of flags
- operand: filter operand
The available flags are:
- casesensitive: (default), this flag forces a case-sensitive match, where upper and lower case letters are considered different
- caseinsensitive: overrides the default so that upper and lower case letters are considered identical for matching purposes
New in: 5.1.20The mathematics filter operators allow numerical calculations to be performed within filters.
The mathematics operators interpret their arguments as numbers according to the following rules:
- Any non-numeric characters after a valid number are ignored (e.g.
28pxis interpreted as the number 28) - If the argument cannot be interpreted as a number, the value 0 is used (e.g.
foois interpreted as the number 0) - The special values
Infinityand-Infinitycan be used to represent positive and negative infinity respectively
The mathematics operators take three different forms:
- Unary operators apply an operation to each number in the input list (e.g. negate, truncate, sign)
=1 =2 =3 =4 +[negate[]]evaluates to-1-2-3-4=1.2 =2.4 =3.6 =4.8 +[trunc[]]evaluates to1234=1.2 =2.4 =3.6 =4.8 +[round[]]evaluates to1245
- Binary operators apply an operation and operand to each number in the input list (e.g. add, multiply, remainder)
=1 =2 =3 =4 +[add[3]]evaluates to4567=1 =2 =3 =4 +[multiply[8]]evaluates to8162432
- Reducing operators apply an operation to all of the numbers in the input list, returning a single result (e.g. sum, product)
=1 =2 =3 =4 +[sum[]]evaluates to10=1 =2 =3 =4 +[product[]]evaluates to24
Operators can be combined:
[[355]divide[113]fixed[5]]evaluates to3.14159[range[100]sum[]divide[100]]evaluates to50.5[tag[HelloThere]get[text]length[]sum[]]evaluates to9701
Complex operations will sometimes need to be split up into separate filters. For example, to compute the average length of the text field of tiddlers tagged "HelloThere":
<$set name="number-of-tiddlers" value={{{ [tag[HelloThere]count[]] }}}>
Average length of <$text text=<<number-of-tiddlers>>/> tiddlers tagged <<tag "HelloThere">>: <$text text={{{ [tag[HelloThere]get[text]length[]sum[]divide<number-of-tiddlers>fixed[3]] }}}/>
</$set>Este es su aspecto:
Average length of 6 tiddlers tagged : 1616.833
An experimental MathJax plugin for TiddlyWiki version 5. As Martin says, the implementation is a bit of a hack but may be useful until we have a better alternative.
http://mathjax-tw5.kantorsite.net
Welcome. I have created plugin for TiddlyWiki 5 which allows you to use MathJax (math in TeX and MathML) inside TiddlyWiki 5. It's unofficial plugin and it doesn't follow general policy of TiddlyWiki as stand-alone solution but it works. So you can use it if you want.
MathML es un lenguaje de marcas para notación matemática que puede usarse en HTML.
Si tu navegador lo soporta, los elementos de MathML pueden usarse en WikiText como HTML.
Este es un ejemplo de matriz MathML sacado de W3C:
<math><mrow><mo>[</mo><mtable><mtr><mtd><mn>0</mn></mtd><mtd><mn>1</mn></mtd><mtd><mn>0</mn></mtd></mtr><mtr><mtd><mn>0</mn></mtd><mtd><mn>0</mn></mtd><mtd><mn>1</mn></mtd></mtr><mtr><mtd><mn>1</mn></mtd><mtd><mn>0</mn></mtd><mtd><mn>0</mn></mtd></mtr></mtable><mo>]</mo></mrow></math>Y se ve así:
| purpose | treating each input title as a number, take the maximum of its value and the numeric value of the operand |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers, with any that are less than N being replaced by N |
New in: 5.1.20 See Mathematics Operators for an overview.
See also the min Operator, and compare with the maxall Operator and the minall Operator.
| purpose | find the largest of a list of numbers |
|---|---|
| input | a selection of titles |
| output | the largest of the input numbers |
New in: 5.1.20 See Mathematics Operators for an overview.
See also the minall Operator, and compare with the max Operator and the min Operator.
Reuniones presenciales que los entusiastas de TiddlyWiki celebran en todo el mundo:
- OXTWIG, el Oxford TiddlyWiki Interest Group se reúne mensualmente en Oxford, Gran Bretaña, para compartir experiencias de uso de TiddlyWiki
- TiddlyWiki Camp Paris es un evento de un día de celebración y exploración de TiddlyWiki, tanto para usuarios expertos, como para principiantes.
Si tú también compartes nuestro entusiasmo por TiddlyWiki, anímate a organizar un TWIG local en tu ciudad. Es una manera magnífica de promover el uso y el interés por TiddlyWiki
Son mensajes generados por widgets en respuesta a acciones del usuario. Estos mensajes recorren la estructura en árbol del widget hasta que encuentran el ascendiente que los procesa.
El núcleo lleva implementados los siguientes mensajes:
- tm-add-field
- tm-add-tag
- tm-auto-save-wiki
- tm-browser-refresh
- tm-cancel-tiddler
- tm-clear-password
- tm-close-all-tiddlers
- tm-close-other-tiddlers
- tm-close-tiddler
- tm-copy-to-clipboard
- tm-delete-tiddler
- tm-download-file
- tm-edit-bitmap-operation
- tm-edit-text-operation
- tm-edit-tiddler
- tm-focus-selector
- tm-fold-all-tiddlers
- tm-fold-other-tiddlers
- tm-fold-tiddler
- tm-full-screen
- tm-home
- tm-import-tiddlers
- tm-load-plugin-from-library
- tm-load-plugin-library
- tm-login
- tm-logout
- tm-modal
- tm-navigate
- tm-new-tiddler
- tm-notify
- tm-open-external-window
- tm-open-window
- tm-perform-import
- tm-permalink
- tm-permaview
- tm-print
- tm-remove-field
- tm-remove-tag
- tm-rename-tiddler
- tm-save-tiddler
- tm-save-wiki
- tm-scroll
- tm-server-refresh
- tm-set-password
- tm-unfold-all-tiddlers
- tm-unload-plugin-library
| purpose | treating each input title as a number, take the minimum of its value and the numeric value of the operand |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers, with any that are greater than N being replaced by N |
New in: 5.1.20 See Mathematics Operators for an overview.
See also the max Operator, and compare with the maxall Operator and the minall Operator.
| purpose | find the smallest of a list of numbers |
|---|---|
| input | a selection of titles |
| output | the smallest of the input numbers |
New in: 5.1.20 See Mathematics Operators for an overview.
See also the maxall Operator, and compare with the max Operator and the min Operator.
| purpose | filter items shorter than the specified minimum length |
|---|---|
| input | a list of items |
| parameter | minlength = the minimum length for items |
| output | those items at least as long as the specified minimum length |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]minlength[7]]
[list[Days of the Week]minlength[1]]
[
{
"title": "HelloThere",
"fromPageRect": {
"top": 494.26666259765625,
"left": 1022.3333129882812,
"width": 79,
"right": 1101.3333129882812,
"bottom": 511.26666259765625,
"height": 17
}
}
]The Mobile Drag And Drop Shim Plugin provides a "shim" that enables HTML 5 compatible drag and drop operations on mobile browsers, including iOS and Android. The shim was created by Tim Ruffles and is published at https://github.com/timruffles/ios-html5-drag-drop-shim.
Los diálogos modales (o "asistentes" difuminan la ventana principal de TiddlyWiki para mostrar un tiddler aislado que el usuario tiene que atender explícitamente.
Los modales se muestran mediante el mensaje tm-modal.
Within the action string of the DroppableWidget, the modifier variable contains the modifier key(s) held during the drag-process. The possible keys are ctrl, shift or both ctrl and shift
The variable contains a string that identifies the keys:
| Modifier Key | Variable Content |
| ctrl | ctrl |
| shift | shift |
| ctrl+shift | ctrl-shift |
| no modifier (normal drag) | normal |
A module in TiddlyWiki5 is a tiddler containing executable JavaScript, of the type application/javascript and with the field module-type set to the ModuleType of the module.
See control panel > Info > Advanced > Loaded Modules for a list of currently loaded modules.
| purpose | select the names of all modules of the input module types |
|---|---|
| input | a selection of module types |
| parameter | none |
| output | the title of each module with any of the input types |
The module-type field of a JavaScript module is a string that identifies the type of the module. Here is a list of the module types used in this wiki:
- allfilteroperator
- A sub-operator for the all filter operator.
- animation
- Animaciones que pueden usarse con RevealWidget
- authenticator
- Defines how requests are authenticated by the built-in HTTP server.
- bitmapeditoroperation
- A bitmap editor toolbar operation.
- command
- Comandos que pueden ejecutarse en Node.js
- config
- Datos para insertar en
$tw.config - filteroperator
- Operadores individuales de filtrado
- global
- Datos globales para insertar en
$tw - indexer
- info
- Publishes system information via the $:/temp/info-plugin pseudo-plugin.
- isfilteroperator
- Operandos para el operador is
- library
- Generic module type for general purpose JavaScript modules.
- macro
- Definiciones macro de JavaScript.
- parser
- Reglas sintácticas para diversos tipos de contenido.
- route
- Defines how individual URL patterns are handled by the built-in HTTP server.
- saver
- Guarda archivos desde el navegador con diferentes métodos.
- startup
- Funciones de inicio
- storyview
- Personaliza la animación y comportamiento de listas
- texteditoroperation
- A text editor toolbar operation.
- tiddlerdeserializer
- Convierte diferentes tipos de contenido en tiddlers
- tiddlerfield
- Define el comportamiento de un campo individual
- tiddlermethod
- Añade métodos al prototipo
$tw.Tiddler - upgrader
- Aplica la actualización a los tiddlers durante el proceso de actualización/importación.
- utils
- Añade métodos a
$tw.utils - utils-node
- Añade métodos específicos de Node.js a
$tw.utils - widget
- Encapsula la representación y recarga de DOM
- wikimethod
- Añade métodos a
$tw.Wiki - wikirule
- Reglas individuales del intérprete principal de WikiText
| purpose | select the names of all TiddlyWiki module types |
|---|---|
| input | ignored |
| parameter | none |
| output | the name of each known TiddlyWiki module type, in alphabetical order |
';. .;c'
:XNo ,kjack' .:dd
,K0X: '0l Tiddly:',..,Wiki.
jacK' .dk. '';jack .xk;
Jack; ..',','... '0c .0c
:0:c0l. .:dTidllyc::cjoWikioc:,,,,;;:cJACKc:;;d0. 'K:
l0:'jack,... ...',:lkxc. ..';:ccc:;;,'...',:loc .Kc
,xk:..,jackjackjack;'. :K,
.lxxl;.. . .Ox.
.':lTiddlyWikI. .xk.
`` ;0; . ;Od.
.dO' .0Ojackx,
cOo' .kk'.'..
.k0' .cOo.
lO; ... .jack.
.xk' .jackTiddlyWikijackO, .lkd;.
;Oo. .dO. .ok. ,Oo.
l0; .c, ,0: .kd l0.
.xk. .xNx lO. lO. ;0,
.Od. ,XW0, :0; dk. .kx.
.kx. jACKx' cOl. .Ol ;0:
.oO: .JACKx. .jack;'. .0: c0;
'dkc ,lXKd' .'jack. .Ol cOc.
.;ljack,.;xkc,...,oK, 'xxjack. .oko.
`` 'cljack' .okdlcJack.
'JacK,'
| purpose | move marker N places in the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | marker = the list item to be used as a marker |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[move[Wednesday]]
[list[Days of the Week]] +[move:-2[Wednesday]]
| purpose | treating each input title as a number, multiply it by the numeric value of the operand |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers, but with each one multiplied by N |
MultiTiddlerFiles allow multiple tiddlers to be concisely represented in a single text file.
The goals of this format are:
- To be easy to type and easy to read
- Optimised for single line strings
- To allow common fields or tags to be shared within groups of tiddlers
- To be simple to process with external tools
MultiTiddlerFiles have the extension multids. The file is structured as a block of shared fields followed by a blank line. The rest of the file is a sequence of comments and tiddlers. Tiddlers are specified by their title, followed by a colon, at least one space character, and then the rest of the line is the text field for the tiddler.
For example:
title: $:/language/ControlPanel/
tags: strings
modifier: JoeBloggs
Basics/Caption: Basics
# This is a comment
Basics/Version: ~TiddlyWiki VersionThis example defines two tiddlers, $:/language/ControlPanel/Basics/Caption and $:/language/ControlPanel/Basics/Version.
If a title field is specified in the header then it is treated as a prefix for the individual tiddlers defined in the title.
Syntax Specification
MultiTiddlerFiles
Header Line
Tiddler Descriptor Line
Comment Line
[
{
"title": "HelloThere",
"fromPageRect": {
"top": 629,
"left": 304,
"width": 80,
"right": 384,
"bottom": 647,
"height": 18
}
},
{
"title": "HelloThere",
"fromPageRect": {
"top": 516.2666625976562,
"left": 1022.3333129882812,
"width": 79,
"right": 1101.3333129882812,
"bottom": 533.2666625976562,
"height": 17
}
}
]New in: 5.1.18 Most TiddlyWiki Commands use a position-based system for their parameters where each parameter must be listed in the precise order defined by the command. Some of the more complex commands offer an alternative scheme of named command parameters. For example, here we provide two parameters named "port" and "host":
--listen port=8090 host=0.0.0.0Note that the order of the parameters does not matter.
Using special characters within a parameter requires quoting. Unix, Linux and the Mac use single quotes, and Windows uses double quotes:
--listen port=8090 username=joe 'password=s3cret(!'
--listen port=8090 username=joe "password=s3cret(!"Note that the quotes are applied to the entire name=value pair, not just to the value part.
The system tiddlers provided as part of the core are named according to the following rules:
| Namespace | Format | Description |
|---|---|---|
$:/* | CamelCase | Root user interface tiddlers (eg control panel, advanced search) |
$:/config/* | CamelCase | User-oriented configuration setting |
$:/core/images/* | hyphen-case | Core images |
$:/core/modules/* | lowercase | JavaScript module tiddlers |
$:/core/save/* | lowercase | Saving templates for creating TiddlyWiki documents |
$:/core/templates/* | inconsistent | Templates needed for TiddlyWiki to operate. Currently uses a mix of dashes and periods to separate words |
$:/core/ui/* | inconsistent | Tiddlers comprising the default user interface of TiddlyWiki. Currently uses a mix of CamelCase and lowercase naming conventions |
$:/core/wiki/* | lowercase | Metadata about the entire wiki |
$:/docs/* | lowercase | Documentation tiddlers |
$:/messages/* | CamelCase | System messages |
$:/plugins/* | lowercase | Plugin tiddlers, and plugin content |
$:/snippets/* | inconsistent | Reusable snippets (will be replaced by macros) |
$:/state/* | lowercase | User interface state tiddlers |
$:/tags/* | CamelCase | User interface configuration tags |
$:/temp/* | lowercase | Temporary tiddlers that shouldn't be saved |
$:/themes/* | lowercase | Theme plugins |
In the format column:
- hyphen-case refers to joining multiple lowercase words with hyphens
- CamelCase refers to directly joining multiple lowercase words with initial uppercase letters
- lowercase refers to directly joining multiple lowercase words
- inconsistent marks namespaces that are currently titled inconsistently
En la vista por defecto "classic", los tiddlers abiertos se muestran en una columna vertical llamada StoryRiver. Hay varias maneras de moverse por ella, saltando adelante y atrás entre los diferentes tiddlers abiertos.
- La más sencilla es por medio de la pestaña Abiertos de la barra lateral.
- La pestaña Abiertos contiene la lista de tiddlers abiertos. Pinchando en cualquiera de ellos se salta a ese tiddler y haciéndolo en la "x" junto al título, se cierra. Hay también un práctico botón "cerrar todo" abajo del todo de la lista.
- Otra manera es desplazándose por la página, usando bien la rueda del ratón o la barra de desplazamiento de la derecha.
- Cuando la barra lateral y la StoryView se extienden más allá de la pantalla visible, habrá dos barras. La de más a la derecha controla la StoryRiver. La otra, la barra lateral.
- Otra forma posible, usada por muchos principiantes, consiste en cerrar tiddlers de uno en uno hasta llegar al que están buscando.
- Al cerrar un tiddler del principio o del medio de la lista hará que los tiddlers de más abajo se deslicen "río arriba", poniendo a la vista el tiddler inmediatamente debajo del que se acaba de cerrar.
Introducción
El widget Navegador manipula el TiddlerStore, StoryList y HistoryList en respuesta a una serie de mensajes.
Contenido y atributos
El widget muestra en pantalla su contenido y responde a los mensajes que se le envían
The navigator widget displays any contained content, and responds to Messages dispatched within it.
| Atributo | Descripción |
|---|---|
| story | Nombre del tiddler que contiene el StoryList que se va a manipular |
| history | Nombre del tiddler que contiene el HistoryList que se va a manipular |
| openLinkFromInsideRiver | Determina dónde se van a abrir los tiddlers nuevos que se invoquen desde dentro del StoryRiver: al principio o al final del StoryRiver o encima o debajo del tiddler actual |
| openLinkFromOutsideRiver | Determina dónde se van a abrir los tiddlers nuevos que se llamen desde fuera del StoryRiver: al principio o al final del StoryRiver |
Mensajes del widget
El navegador maneja los siguientes mensajes:
- WidgetMessage: tm-cancel-tiddler
- WidgetMessage: tm-close-all-tiddlers
- WidgetMessage: tm-close-other-tiddlers
- WidgetMessage: tm-close-tiddler
- WidgetMessage: tm-delete-tiddler
- WidgetMessage: tm-edit-tiddler
- WidgetMessage: tm-import-tiddlers
- WidgetMessage: tm-new-tiddler
- WidgetMessage: tm-perform-import
- WidgetMessage: tm-rename-tiddler
- WidgetMessage: tm-save-tiddler
| purpose | calculate the negation of a list of numbers |
|---|---|
| input | a selection of titles |
| output | the negation of the input numbers |
New in: 5.1.20 See Mathematics Operators for an overview.
| purpose | find which titles in a list field follow the input ones |
|---|---|
| input | a selection of titles |
| parameter | T = a tiddler title |
| output | a selection containing each title that immediately follows each of the input titles in the list field of T |
Each input title is processed in turn, and its successor is located in the list field and appended to the output. If a title is not listed in the field, or is the last title there, then it contributes nothing to the output.
These examples make use of the Days of the Week tiddler.
[[Monday]next[Days of the Week]]
[[Sunday]next[Days of the Week]]
Tuesday Wednesday Thursday +[next[Days of the Week]]
Node.js is a downloadable application for your PC, Mac or Linux computer that lets it run JavaScript applications. Unlike JavaScript applications running in a web browser, Node.js code has full access to the file system and other resources of the computer, enabling it to perform the roles that have traditionally been the preserve of languages like Java, PHP and Python. See http://nodejs.org for more details.
For TiddlyWiki, Node.js means that we can have a single code base that can run in the browser or on the server, giving great flexibility in how it is used.
For end users, Node.js is no more complicated to install than a web browser, but unlocks powerful capabilities such as the ability to run TiddlyWiki as a web server that you can connect to from other devices.
See TiddlyWiki on Node.js for more details.
Version 5.0.11-beta includes some changes that can break content from earlier releases of TiddlyWiki 5.
Command line changes
Previously, commands that generate output files would interpret the specified path to the file as being relative to the current working directory. So, for example, the following command would write index.html to the current directory:
tiddlywiki mywiki --rendertiddler $:/core/save/all index.html text/plainIn 5.0.11-beta this behaviour has changed, and now the specified filename is resolved relative to an output folder within the TiddlyWikiFolder. So the command above will now write the file index.html to mywiki/output/index.html.
You can override this behaviour with the OutputCommand. For example, to generate the index.html file within the current directory:
tiddlywiki mywiki --output . --rendertiddler $:/core/save/all index.html text/plainA further change is that the --rendertiddlers command now clears the output folder before it writes any files. This means that any previous --rendertiddler commands to the same folder will have their output deleted.
Version 5.0.8-beta includes some changes that can break content from earlier releases of TiddlyWiki 5.
Change to $:/SiteTitle and $:/SiteSubtitle
You should rename any existing SiteTitle and SiteSubtitle tiddlers to $:/SiteTitle and $:/SiteSubtitle respectively.
Changed parsing rules for content of HTML elements
Version 5.0.8-beta marks a change in the way that TiddlyWiki determines whether to parse the content of an HTML element or widget in block mode or inline mode.
- In block mode, TiddlyWiki parses text into paragraphs, creating
<p>tags to wrap them. It also recognises block syntax like headings, lists and tables. - In inline mode, TiddlyWiki ignores paragraph formatting, and just recognises character formatting, like bold and italic.
It's important to be able to control which type of parsing is performed for different situations.
Prior to 5.0.8-beta, TiddlyWiki parsed the content of an element in inline mode unless the opening tag of the element were immediately followed by a line break. This meant that much of the time element tags would be shunted together into a long line, hindering readability.
The new behaviour for 5.0.8-beta is to parse the content of an element in inline mode unless the opening tag is immediately followed by two line breaks.
To adjust existing content for 5.0.8-beta you will need to manually add the additional line break after the opening tag of elements and widgets whose content should be parsed in block mode.
The positive aspect of the change is that it removes the need to pack multiple HTML tags onto a single line, improving readability.
Examples
Consider the difference between these two examples. First, here's an HTML tag that starts with two line breaks:
<blockquote>
! This is a heading
And a paragraph of text.
</blockquote>
Tiene este aspecto:
This is a heading
And a paragraph of text.
... y su código HTML es:
<blockquote><h1 class="">This is a heading</h1><p>And a paragraph of text.</p></blockquote>
Secondly, here's an HTML tag with just a single line break. Notice how the heading is no longer recognised as a heading
<blockquote>
! This is a heading
And a paragraph of text.
</blockquote>
Tiene este aspecto:
! This is a heading And a paragraph of text.
... y su código HTML es:
<p><blockquote> ! This is a heading And a paragraph of text. </blockquote> </p>
Changed commands for TiddlyWiki on Node.js
The handling of wiki folders has changed. Previously, if the tiddlywiki command was run against a wiki folder that didn't have the necessary tiddlywiki.info file then it would be automatically created. Now, the wiki folder must be initialised with the InitCommand.
This is how to create and start a new server-based wiki:
tiddlywiki mywikifolder --init server
tiddlywiki mywikifolder --serverNote that the name of the clientserver edition has changed to server.
Las notificaciones son pequeños mensajes de información que aparecen en la esquina superior derecha de la ventana y que desaparecen automáticamente.
The now macro returns the current date and time in a specified format.
The value doesn't update automatically, like a ticking clock. It updates whenever the macro call is rendered, such as when the containing tiddler's display needs to be refreshed for some other reason.
Parameters
- format
- A string specifying the desired format, defaulting to
0hh:0mm, DDth MMM YYYY
Note: The format string [UTC]YYYY0MM0DD0hh0mm0ssXXX will return a date string representing the UTC time-stamp as it is used in the TiddlyWiki created and modified time-stamp fields.
| purpose | sort the input by number field |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as numbers |
! output | the input, likewise sorted into descending order |
| purpose | sort the input titles by number field, treating upper and lower case as different |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as numbers |
! output | the input, likewise sorted into descending order |
10 010 1000 100 +[nsortcs[]]
10 010 ALPHA beta alpha 1000 100 +[nsortcs[]]
| purpose | select the Nth input title |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | the Nth input title |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]nth[]]
[list[Days of the Week]nth[5]]
NW.js is an OpenSource application that fuses the functionality of a web browser with that of Node.js. It makes it possible to use web applications as though they were native apps, with full access to the file system and other native facilities. Learn more from the official site or this introductory blog post.
See TiddlyWiki on NW.js for details of how to use TiddlyWiki with NW.js.
Introducción de Dave Gifford al libro bíblico de Abdías, que usa la macro Índice y varios ajustes personalizados de TiddlyWiki: botones "nuevo aquí", esta plantilla personalizada de visualización para añadir notas e imágenes dentro de cualquier tiddler y un tiddler de transclusión para facilitar la impresión (este tiddler)
The official TiddlyWiki plugin library contains the plugins that are part of the main TiddlyWiki 5 GitHub repository. Install them from the plugin library. Plugins from the official plugin library are automatically updated as part of the upgrade process.
OpenSource is defined by Wikipedia as a philosophy, or pragmatic methodology that promotes free redistribution and access to an end product's design and implementation details.
Cuando TiddlyWiki genera una lista de los tiddlers que comparten una etiqueta en particular (p. ej, en la lista que aparece al pinchar en una etiqueta), los ordena conforme a las siguientes reglas:
- Primero, los declarados en el campo
listdel TagTiddler y en el orden que este indica - Luego, los no-declarados que tengan el campo
list-before, que van inmediatamente antes del título que respectivamente indiquen.- Si el campo existe pero tiene valor en blanco, el tiddler se coloca al principio de la lista. En caso de que sean varios los tiddlers etiquetados no declarados que tienen el campo
list-beforeen blanco, se colocarán por orden alfabético ascendente al principio de la lista, ignorando mayúsculas y minúsculas.
- Si el campo existe pero tiene valor en blanco, el tiddler se coloca al principio de la lista. En caso de que sean varios los tiddlers etiquetados no declarados que tienen el campo
- A continuación, los no-declarados que tengan el campo
list-after, que van inmediatamente después del título que respectivamente indiquen. - Finalmente, cerrando la lista, por orden alfabético ascendente, ignorando mayúsculas y minúsculas, todos los demás tiddlers que queden.
| purpose | selectively reverse the input list |
|---|---|
| input | a selection of titles |
| parameter | F = Either the string reverse or another value |
| output | the input, with the order reversed if F is the special value reverse |
Either reverses or preserves the order of the input list according to whether the parameter is the special value reverse.
Founded in 2004 by JeremyRuston, Osmosoft was originally a consultancy for software services around TiddlyWiki. Notable engagements included working with Socialtext on Socialtext Unplugged.
In 2007, Osmosoft was acquired by BT and became the champions for open source within the enterprise. As part of BT, Osmosoft has worked on a diverse range of projects within BT and for BT's customers.
Establece el directorio de salida para los comandos que le siguen
El directorio por defecto es el subdirectorio output, en el directorio del wiki
--output <pathname>Si la ruta especificada es relativa, se interpreta como relativa al directorio actual de trabajo
Por ejemplo: --output . establece como directorio de salida el actual directorio de trabajo
El OXTWIG: Oxford TiddlyWiki Interest Group se reúne mensualmente para conversar y hacer demostraciones de TiddlyWiki.
Ver https://oxtwig.eventbrite.co.uk/ para más información sobre nuestra próxima reunión.
También tenemos lista de correo: https://groups.google.com/forum/#!members/oxtwig
OXTWIG #2
La segunda reunión del OXTWIG se celebró el jueves 16 de enero de 2014:
OXTWIG #1
La primera reunión del OXTWIG se celebró el jueves 21 de noviembre de 2013:
Algo que muchos usuarios desconocen es hasta qué punto pueden customizar TIddlyWiki simplemente añadiendo o quitando etiquetas de sistema de tiddlers ocultos clave o de sus propios tiddlers.
- Puedes añadir o quitar funciones por defecto en tiddlers, tanto en modo de visionado como en modo de edición (digamos que encuentras que el subtítulo de tiddler distrae o que quieres añadir un recordatorio para cuando se editen tiddlers)
- También puedes añadir o quitar funciones por defecto en el diseño general de la página (quizá necesites un reloj en la barra lateral, o sustituir uno de los botones de control por otro que hayas hecho tú)
- O puedes reorganizar el orden en que se muestran (quizá prefieres mostrar las etiquetas por encima del título, o que el subtítulo de la página aparezca por debajo de los botones)
Una vez sepas qué es lo que quieres hacer, te parecerá que todas estas cosas son bastante fáciles.
Añadir tiddlers a medida a la interfaz de usuario
Puedes crear el tiddler que quieras y asignarle la etiqueta de sistema apropiada para que aparezca en tal o cual sitio. Por ejemplo, si creas un tiddler llamado "Recordatorio" con el texto "Esto es un recordatorio" y la etiqueta $:/tags/EditTemplate, las palabras "Esto es un recordatorio" aparecerán en todos los tiddlers que abras para edición.
Al crear tiddlers para que se muestren dentro de otros tiddlers o para que formen parte del diseño de página, necesitarás con toda probabilidad reorganizar el diseño para que tus tiddlers se muestren exactamente donde quieres que aparezcan. Para hacerlo, edita el tiddler oculto apropiado con el prefijo $:/tags e incluye el título de tu tiddler en el lugar adecuado del campo list. Por ejemplo, si quieres que la frase "Esto es un recordatorio" del ejemplo anterior aparezca por encima del editor de etiquetas en modo de edición, edita el tiddler $:/tags/EditTemplate e inserta [[Recordatorio]] en el campo list, justo antes de $:/core/ui/EditTemplate/tags
Crear nuevos botones en la barra de tiddler y los controles de página
Digamos que tienes un tiddler llamado Plantilla Recetas y quieres un botón que cree nuevas recetas a partir de él. Para hacerlo tendrás que hacer lo siguiente:
- Primero, necesitarás una imagen para el botón. Si ninguna de las imágenes del sistema (tiddlers ocultos con el prefijo y la etiqueta
$:/core/images), necesitarás crear o buscar una imagen SVG para ello (por ejemplo una de http://flaticon.com).- En cualquier caso, arrástrala a tu página para importarla, edita convenientemente el tiddler y ajusta sus dimensiones a 22px x 22px
- Necesitarás crear un tiddler que contenga el botón. Créalo, dale título y añade el código para habilitar el botón:
\define newHereButtonTags() [[$(currentTiddler)$]] \end \define newHereButton() <$button class=<<tv-config-toolbar-class>>> <$action-sendmessage $message="tm-new-tiddler" $param="TÍTULO DE LA PLANTILLA QUE QUIERES QUE ABRA" title="New tiddler" tags=<<newHereButtonTags>> /> <$list filter="[<tv-config-toolbar-icons>prefix[yes]]"> {{NOMBRE DE LA IMAGEN DEL BOTÓN}} </$list> <$list filter="[<tv-config-toolbar-text>prefix[yes]]"> <span class="tc-btn-text"><$text text="NOMBRE DEL BOTÓN PARA MOSTRAR EN PANTALLA"/></span> </$list> </$button> \end <<newHereButton>>- Asígnale la etiqueta
$:/tags/ViewToolbar]]
- Hay que crear un tiddler que le diga a TiddlyWIki si el botón será o no visible en la barra. Llamémosle por ejemplo
$:/config/ViewToolbarButtons/Visibility/Receta. Escriberevealen el cuerpo y guárdalo. - Habrá que posicionar el botón adecuadamente. Abre el tiddler
$:/tags/ViewToolbare inserta el nombre de tu botón en el lugar adecuado del campolist.
Eliminar tiddlers ocultos de la interfaz de usuario
En la subpestaña Ocultos de la pestaña Más en la barra lateral, verás la lista de todos los tiddlers ocultos. En ella verás algunos con el prefijo $:/core/ui/. Estos son los que definen la interfaz de usuario y llevan etiquetas de sistema. Añadir o eliminar estas etiquetas modifica el diseño, tanto de los tiddlers, como de la página entera.
Por ejemplo: $:/core/ui/SideBar/More es el tiddler que define la pestaña Más. Si le quitas la etiqueta, quitarás dicha pestaña de la barra lateral y si se la vuelves a asignar, volverás a mostrarla.
Puedes aplicar el mismo procedimiento para cualquier tiddler de la interfaz que lleve el prefijo $:/core/ui/. Por ejemplo, quitar la etiqueta de sistema al tiddler $:/core/ui/ViewTemplate/subtitle eliminará el subtítulo de todos los tiddlers.
Si modificas un tiddler oculto de esta manera, sobreescribirás el valor predefinido. Para revertirlo a su origen, simplemente borra el tiddler modificado para restaurar el tiddler oculto.
To mark the end of a paragraph in TiddlyWiki you need to type enter twice to create a double line break:
This is the first paragraph.
And this is the second paragraph.Single line breaks are ignored within paragraphs. For example:
This is a
paragraph made
up of
short linesTiene este aspecto:
This is a paragraph made up of short lines
... y su código HTML es:
<p>This is a paragraph made up of short lines</p>
For situations where this behaviour isn't convenient, you can also use Hard Linebreaks in WikiText.
Introduction
The password widget displays a password input box that is bound to a named entry in the TiddlyWiki5 PasswordVault. Passwords are currently stored in the browsers local storage and are not themselves encrypted.
Content and Attributes
The content of the <$password> widget is ignored.
| Attribute | Description |
|---|---|
| name | Name of the password vault entry |
Percent encoding is a notation that allows otherwise invalid characters to be included in a URI.
Such characters are represented as a percent sign % followed by two additional characters.
For example, a space is represented as %20 and an actual percent sign is represented as %25.
TiddlyWiki ships with defaults that are designed to get the best out of modern devices from smartphones to desktop computers. If you need to work on older, less powerful devices, or work with large amounts of content, there are a few steps you can take to improve performance.
- Avoid the "Recent" tab. It is computationally slow to generate and update in response to tiddler changes.
- Use the "Vanilla" theme. The default "Snow White" theme includes visual effects like shadows, transparency and blurring that can be slow to render on older devices
- Avoid large tiddlers. Large bitmaps can significantly slow TiddlyWiki's performance. For example, an image taken with a modern smartphone will often be 5MB or more. Use ExternalImages whenever possible
- Don't have too many tiddlers open at once. Every tiddler you have open will require processing to keep it up to date as the store changes (for example, while you type into a draft tiddler). It is particularly easy when using zoomin story view to end up with dozens of tiddlers listed in the Open tab in the sidebar. Get into the habit of periodically closing all open tiddlers with the close all button
- Use the built-in performance instrumentation. Studying the performance instrumentation results can help highlight performance problems
- Take advantage of indexed filter operators. The following constructions at the start of a filter run will be optimised to run many times faster than otherwise:
[all[tiddlers]tag[x]...[all[shadows]tag[x]...[all[tiddlers+shadows]tag[x]...[all[shadows+tiddlers]tag[x]...[all[tiddlers]field:y[x]...[all[shadows]field:y[x]...[all[tiddlers+shadows]field:y[x]...[all[shadows+tiddlers]field:y[x]...- Note that the field indexer currently defaults to indexing field values of less than 128 characters; longer values can still be searched for, but no index will be constructed
- Also note that the “field” operator is also used when the operator name is a fieldname, so, for example,
[all[shadows+tiddlers]caption[x]...is optimised.
The core has built-in performance instrumentation for the refresh cycle. See “Performance Instrumentation” on the “Settings” tab of control panel. The wiki will need to be reloaded before it takes effect.
With performance instrumentation switched on, there is additional timing information displayed the browser developer console each time a refresh cycle is triggered. For example:
performance: mainRender: 327.83ms
performance: styleRefresh: 9.14ms
performance: mainRefresh: 68.10ms The information above should be interpreted as follows:
- mainRender is the time taken for the initial display of the page template
- styleRefresh is the time taken to refresh the page stylesheet
- mainRender is the time taken to refresh the main page template
As an example, try switching between the sidebar tabs to compare how long they take to render.
More detailed information on filter execution timings is also available. With performance instrumentation enabled, type the following JavaScript command in the browser developer console:
$tw.perf.log()A table is displayed with the following information:
- name - the string "Filter: " plus the text of the filter
- invocations - the number of invocations of the filter since startup
- totalTime - the total time in milliseconds spent evaluating this filter since startup
- percentTime - the percentage of the execution time of this filter against the total execution time of all filters
Un permalink permite enlaces directos a tiddlers individuales de un TiddlyWiki
Permalinks sencillos
La forma más simple de un permalink es un enlace sencillo adjunto a la dirección de base con #:
https://tiddlywiki.com/#HelloThere
El título del tiddler puede contener espacios si es necesario:
https://tiddlywiki.com/#Using TiddlyWiki on Node.js
No es necesario encerrar el título en corchetes dobles, aunque si lo haces, no pasa nada, porque se elmininan.
Permalinks al StoryRiver
El permalink también puede definir la secuencia de tiddlers que se abre junto al tiddler principal, como hace un filtro:
https://tiddlywiki.com/#TiddlerFields:Tiddlers TiddlerTags TiddlerFields ContentType
Si el tiddler principal no está presente entre los tiddlers de la StoryRiver, se inserta automáticamente al principio, lo que significa que estos dos ejemplos apuntan al tiddler Tiddlers en la secuencia Tiddlers, Tags, TiddlerFields:
https://tiddlywiki.com/#Tiddlers:Tags TiddlerFields
https://tiddlywiki.com/#Tiddlers:Tiddlers Tags TiddlerFields
También es posible definir un filtro sin especificar un tiddler en concreto:
https://tiddlywiki.com/#:[tags[task]]
Codificación de URL's
Existen restricciones técnicas a los caracteres que pueden usarse en una URL. Para permitir apuntar a cualquier tiddler, los caracteres no permitidos están sujetos a un proceso llamado codificación, mediante el cual los caracteres problemáticos se sustituyen por un código numérico, también llamado código por ciento. Así, por ejemplo, el caracter que representa un espacio se sustituye por el código %20.
Tanto el título del tiddler como el filtro de la historia deben codificarse para URL (no así los dos puntos). ~Tiddlywiki genera URL's debidamente codificadas que pueden tener un aspecto bastante aterrador. Sin embargo, en la práctica, los navegadores procesan todos los caracteres en fragmentos de URL, así que cuando creas permalinks de forma manual puedes ignorar la codificación URL.
Comportamiento de los permalinks
Dos importantes aspectos del comportamiento de los permalinks en TiddlyWiki pueden controlarse con las opciones de la pestaña Avanzado/Configuración:
- Actualizar o no la barra del navegador según se navega para que refleje los cambios que se producen al abrir nuevos tiddlers en la historia y en tal caso, si la actualización incluye la secuencia completa de tiddlers navegados
- Actualizar o no el historial del navegador, de modo que se pueda retroceder en la apertura de tiddlers mediante los botones
AdelanteyAtrásdel navegador (desactivado por defecto)
Escribir o navegar a un permalink siempre hará que el navegador lo procese, lo que abre y cierra tiddlers del modo que el permalink requiere, en lugar de, por ejemplo, añadir el permalink a la vista actual de tiddlers.
Detalles técnicos
Al iniciarse y cada vez que un permalink varía dinámicamente –editando la barra de direcciones, por ejemplo–, TIddlyWiki procesa los permalinks conforme a las siguientes reglas.
- Si el permalink contiene dos puntos, considera la cadena anterior como target y la posterior como filtro del StoryRiver
- Si no contiene dos puntos, considera toda la cadena como target y el filtro como "no especificado"
- Si no se especifica filtro, pero sí un target, al arrancar considera que el filtro está en blanco. Si tampoco se especifica target, considera a los tiddlers por defecto como tal.
- Fuera del proceso de arranque, considera la actual lista de tiddlers de la historia un filtro no especificado
- Considera los tiddlers abiertos como lista de tiddlers del permalink
- Si se especifica target, pero no está abierto, lo añade al principio de la lista
- Si se especifica target, lo pone en foco. De otro modo, lo pone en el primer tiddler de la lista
Sistema para crear planes docentes, construido con TiddlyWiki
Construí un programa que sirviera de ayuda para la redacción y planifiación de leciones y que automatizara algunas de las tediosas tareas envueltas en la creación de un plan dociente. <<<
El propósito de guardar y organizar información es poder usarla de nuevo. El valor de la información almacenada es directamente proporcional a la facilidad con la que se puede volver a usar.
La filosofía de los tiddlers consiste en maximizar las posibilidades de reutilización de la información descomponiéndola primero en unidades mínimas, semánticamente significativas, estructurar un entramado de relaciones entre ellas y, por medio de agregación y composición, unir estos fragmentos para presentar una narración o historia.
TiddlyWiki aspira a proporcionar un álgebra de tiddlers, una forma clara y concisa de expresar y explorar relaciones entre unidades mínimas de información significativa.
Estas ediciones contienen demos de los plugins originales de TiddlyWiki y se prepararon para ediciones anteriores, que carecían de la librería de plugins.
Plugin fields
Plugins are stored as tiddlers with the following fields:
| Field | Description |
|---|---|
| title | Title of plugin |
| description | Description of plugin |
| author | Author of plugin |
| version | Version string (must conform to SemanticVersioning convention) |
| source | Source URL of plugin |
| type | Must be application/json |
| plugin-type | Can be plugin (default), language or theme |
| text | JSON encoding of the list of tiddlers comprising the plugin |
| list | Names of exposed plugin information tiddlers (see below) |
| name | Name of the theme (only for themes) |
| dependents | List of dependent plugins (currently only implemented for themes) |
Information Tiddlers for Plugins
Plugin authors are encouraged to provide special information and documentation tiddlers that TiddlyWiki can include as plugin information tabs in the control panel.
Plugins should provide an icon contained in a tiddler with the title formed of <plugin-name>/icon (for example, $:/core/icon).
Plugins expose the names of the individual information tabs that they wish to display in the list field of the plugin tiddler. By convention, some or all of the following should be provided:
- readme: basic information about the plugin
- license: the license under which the plugin is published
The title of the associated information tiddler must be formed as follows:
$:/<plugin-name>/<current-language>/<tab-name>(for example, $:/core/en-GB/readme)$:/<plugin-name>/<tab-name>(for example, $:/core/readme)
Thus, plugins can provide language-specific versions of each information tiddler.
Note that information tiddlers should not reference other tiddlers within the plugin. This is because plugins containing themes or languages are dynamically switched in and out as they are selected, and so their information tiddlers may not be available for viewing. The control panel uses the 'subtiddler' attribute of the TranscludeWidget to access these tiddlers, which works independently of the plugin switching mechanism.
On the server, plugins can be stored as ordinary JSON tiddlers but it is often more convenient to store them as separate tiddler files within folders. Plugin folders must contain a plugin.info file that contains the metadata for the plugin. It can also optionally identify files external to the plugin folder that should be loaded as tiddlers.
The plugin.info file should contain the following JSON structure:
The JSON structure for plugin tiddlers is as follows:
{
"title": "$:/plugins/publisher/name",
"description": "An exemplary plugin for demonstration purposes",
"author": "JeremyRuston",
"version": "1.2.3-alpha3",
"core-version": ">=5.0.0",
"source": "https://tiddlywiki.com/MyPlugin",
"plugin-type": "plugin",
"list": "readme license history"
}By convention, the titles of the individual tiddlers are prefixed with the title of the containing plugin, but they are not restricted to do so.
Note that if the version field is omitted from a plugin.info file when the plugin folder is packed then it is automatically filled in by the core to the current core version number. This is to ensure that all the core plugins carry the correct version number. Generally plugin authors will want to ensure that they do explicitly specify a version number.
Introduction
Plugins are bundles of tiddlers that are distributed and managed as a single unit by being packed into a single JSON tiddler. Users can install them with drag and drop, or using the plugin library.
The tiddlers within registered plugins behave as ShadowTiddlers: they can be freely overwritten by creating a tiddler with the same title, but deleting that tiddler restores the underlying tiddler value from the plugin.
Plugins have a plugin-type field that may take the following values:
plugin(default) - a plain plugintheme- a theme plugin (see ThemeMechanism)language- for translations only
Plugins can be used to package ordinary content, or can include JavaScript modules that extend and enhance the core TiddlyWiki5 functionality.
Plugins conventionally have a title of the form $:/plugins/publisher/name. Plugins that are part of the core TiddlyWiki distribution have titles of the form $:/plugins/tiddlywiki/name.
When running TiddlyWiki under Node.js, plugins can also be stored as individual tiddler files in PluginFolders.
More information
Los complementos y extensiones (plugins) de TiddlyWiki son componentes opcionales que modifican y extienden su funcionalidad. Puedes instalarlos desde la librería oficial o desde las distintas páginas de recursos publicadas por la comunidad.
Estructuralmente, un plugin es un paquete de tiddlers distribuido conjuntamente como un único tiddler, que puede ser instalado, copiado o borrado como una sola unidad. Cada tiddler que forma parte del plugin es un tiddler oculto. Aquí puedes profundizar sobre el tema sobre cómo funcionan y se implementan a nivel interno.
Los complementos y extensiones pueden contener módulos de JavaScript, hojas de estilos y plantillas. También pueden usarse para distribuir texto común, imágenes, audio o cualquier otro tipo de contenidos.
A collection of plugins from TheDiveO.
TheDiveO's Third Flow plugin construction system:
The ThirdFlow plugin brings to you another way to develop customization plugins for TiddlyWiki 5. It is not enforcing a specific development flow, it simply tries to help you. Otherwise, it tries to stay out of your way.
TheDiveO's FontAwesome plugin:
The FontAwesome plugin supports embedding Font Awesome in TiddlyWiki 5. There is no need to install this font into your operating system in order to use it with TiddlyWiki 5. The font is already embedded in this TiddlyWiki 5 customization plugin instead, so nothing else to install.
A collection of plugins from Uwe Stuehler, including:
- Material Edition, a theme based on Google's "material" design language
- A wrapper for the MUURI plugin, bringing complex "masonry"-style layouts to TiddlyWiki
| purpose | select all shadow titles in the input plugins |
|---|---|
| input | a selection of plugin tiddler titles |
| parameter | none |
| output | all shadow titles contained in the input plugins |
The popup mechanism allows blocks of content to be selectively displayed and positioned with respect to an anchor. It has several parts:
- StateTiddlers to record whether a popup is currently displayed or not
- The RevealWidget to selectively display the popup content
- For "sticky" popups — those that don't close when clicking inside one — set the class attribute to
tc-popup-keep
- For "sticky" popups — those that don't close when clicking inside one — set the class attribute to
- The ButtonWidget to trigger the display of the popup by setting the state tiddler appropriately
A pragma is a special component of WikiText that provides control over the way the remaining text is parsed.
Pragmas occupy lines that start with \. They can only appear at the start of the text, but blank lines are allowed between them. If a pragma line appears in the main body of the text, it is treated as if it was ordinary text.
The following pragmas are available:
\define- for defining a macro
\rules- for adjusting the set of rules used to parse the text
\whitespace trimor\whitespace notrim- New in: 5.1.15 Control whether whitespace is trimmed from the start and end of text runs (the default is notrim). This setting can be useful when the whitespace generated by linebreaks disturbs formatting
\import <filter-expression>- New in: 5.1.18 for importing macro definitions from tiddlers identified by a filter expression
| purpose | convert each number to a string with N significant digits |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers with N significant digits |
New in: 5.1.20 See Mathematics Operators for an overview.
The precision operator returns a string representation of the input number that has exactly the specified number of significant digits, using whichever is shorter of exponential or fixed notation.
123456789 +[precision[3]]
123456789 +[precision[13]]
1.23E23 +[precision[90]]
| purpose | filter the input titles by how they start |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | those input titles that start with S |
! output | those input tiddlers that do not start with S |
In looking for matches for S, capital and lowercase letters are treated as different.
[tag[task]!prefix[Go]]
[prefix[$:/languages/]]
[prefix[$:/]]
[is[system]]| purpose | prepend a range of items from an array to the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to all |
| parameter | list = the array of items to be prepended to the head of the list |
| output | a list with items prepended from the head of the operand array |
! output | a list with items prepended from the tail of the operand array |
These examples make use of the Days of the Week tiddler.
The operator may be used to prepend a number of items to the list.
[list[Days of the Week]prepend[Yesterday Today Tomorrow]]
The operand may list only items without spaces – to include items with spaces, use a reference to an array e.g. prepend the last three short days of the week to the list
[list[Days of the Week]!prepend:3{Days of the Week!!short}]
Generalmente, TiddlyWiki muestra al inicio los tiddlers especificados en $:/DefautTiddlers
A veces, sin embargo, es útil mostrar los mismos tiddlers que estaban abiertos cuando se guardó el archivo. Para hacerlo, en $:/DefautTiddlers en lugar una lista de tiddlers, debe especificarse el siguiente filtro:
[list[$:/StoryList]]Este filtro devuelve la lista de tiddlers que figuran en $:/StoryList, que es donde el sistema almacena el histórico de tiddlers.
| purpose | find which titles in a list field precede the input ones |
|---|---|
| input | a selection of titles |
| parameter | T = a tiddler title |
| output | a selection containing each title that immediately precedes each of the input titles in the list field of T |
Each input title is processed in turn, and its predecessor is located in the list field and appended to the output. If a title is not listed in the field, or is the first item there, then it contributes nothing to the output.
These examples make use of the Days of the Week tiddler.
[[Wednesday]previous[Days of the Week]]
[[Monday]previous[Days of the Week]]
Tuesday Wednesday Thursday +[previous[Days of the Week]]
| purpose | produce the product of the input numbers |
|---|---|
| input | a selection of titles |
| output | the result of multiplying together the input as numbers |
New in: 5.1.20 See Mathematics Operators for an overview.
Compare with the multiply Operator.
| purpose | move N trailing items after the marker |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | marker = the list item to be used as a marker |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[putafter[Wednesday]]
[list[Days of the Week]] +[putafter:2[Tuesday]]
[list[Days of the Week]] [[Yesterday]] [[Today]] [[Tomorrow]] +[putafter:3[Tuesday]]
| purpose | move N trailing items before the marker |
|---|---|
| input | a selection of titles |
| suffix | an integer N, defaulting to 1 |
| parameter | marker = an integer, defaulting to 1 |
| output | the first N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[putbefore[Wednesday]]
[list[Days of the Week]] +[putbefore:2[Tuesday]]
[list[Days of the Week]] [[Yesterday]] [[Today]] [[Tomorrow]] +[putbefore:3[Tuesday]]
| purpose | move N trailing items to the head of the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | ignored |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[putfirst[]]
[list[Days of the Week]] +[putfirst:2[]]
[list[Days of the Week]] [[Yesterday]] [[Today]] [[Tomorrow]] +[putfirst:-2[]]
| purpose | move N leading items to the tail of the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | ignored |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[putlast[]]
[list[Days of the Week]] +[putlast:2[]]
one two three [list[Days of the Week]] +[putlast:-3[]]
Answer: New in: 5.1.16
If tiddler has both: this AND tag that create an orange border.
[data-tags*="bar"][data-tags*="froz"] {
border: 2px solid orange;
}If your CSS looks like this:
[data-tags~="this"] {
border: 2px solid blue;
}
[data-tags~="that"] {
border: 2px solid red;
}this creates a blue border
that creates a red border
If you swap positions, you get it the other way around.
Answer: New in: 5.1.16
Either tag this or tag that create a red border.
[data-tags~="this"],
[data-tags~="that"] {
border: 2px solid red;
}Consider the following usecase: New in: 5.1.16
There is a field named: rank, which can hold different values eg: species.
Answer:
The idea is now: We dynamically create the stylesheet. The style-sheet can look like this:
title: myStyles
tags: $:/tags/Stylesheet
<$list filter="[rank[species]]">
[data-tiddler-title^="<$view field=title/>"] .tc-tiddler-body {
column-count: 2;
}
</$list> This creates a CSS rule for every tiddler-title, that has a field rank and value species.
Answer: New in: 5.1.16
- If a tiddler has no tags, but needs styling use:
data-tiddler-titleas CSS selector- There is only one tiddler
- If a user wants to style system tiddlers in a custom way: use:
[data-tiddler-title^="$:"/]as a selector- using the TW namespace functionality
- If the user wants special behaviour for tagged tiddlers. eg: Learning
- use:
[data-tags*="Learning"]as CSS selector.
- use:
The names I'm using are only used for documentation purpose, without changing the existing wiki. I don't want, that the docs has side effects.
The qualify macro is an important part of the StateMechanism.
It returns a unique string that encodes its position within the widget tree, as identified by the stack of transcluded tiddlers that lead to that position.
It is implemented using the transclusion variable.
Parameters
- title
- The prefix for the returned string, normally a tiddler title
The results returned by the qualify macro depend on its location in the transclusion stack.
The two examples below are identical, but produce different results because the second one has been transcluded from another tiddler.
Each example shows the result of calling qualify and then the value of the transclusion variable.
<ul>
<li><code><<qualify "BaseTiddler">></code></li>
<li><code><<transclusion>></code></li>
</ul><ul> <li><code><<qualify "BaseTiddler">></code></li> <li><code><<transclusion>></code></li> </ul>
Wikipedia define un Quine como un programaque produce su código fuente como única salida.
TiddlyWiki es un raro ejemplo de Quine con utilidad práctica: es esa capacidad para producir una copia de su propio código fuente lo que constituye el secreto de su capacidad para almacenar independientemente cambios en sí mismo.
Introduction
The radio widget displays an HTML <input type="radio"> that reflects whether a given tiddler field has a specified value. Selecting the radio button sets to the tiddler field to the value.
Content and Attributes
The content of the <$radio> widget is displayed within an HTML <label> element also containing the radio button. This means that clicking on the content will have the same effect as clicking on the button itself.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler to manipulate (defaults to the current tiddler) |
| field | The field of the tiddler bound to the radio button |
| index | New in: 5.1.14 The index of the tiddler being DataTiddler bound to the radio button |
| value | The value for the field or index of the tiddler |
| class | The CSS classes assigned to the label around the radio button |
Field Mode
This example uses the radio widget to change the modifier field of this tiddler:
<$radio field="modifier" value="JoeBloggs"> Joe Bloggs</$radio>
<$radio field="modifier" value="JaneBloggs"> Jane Bloggs</$radio>Este es su aspecto:
Index Mode
Using the radio widget in index mode requires the index attribute to specify the name of the index of a DataTiddler to which the specified value is assigned.
This example sets the Tree Frog index in the tiddler AnimalColours:
<$tiddler tiddler="AnimalColours">
<$radio index="Tree Frog" value="green"> green</$radio>
<$radio index="Tree Frog" value="brown"> brown</$radio>
</$tiddler>Este es su aspecto:
Los diagramas sintácticos o "de ferrocarril" son una forma visual de explicar las reglas sintácticas de un lenguaje de programación. Para entenderlos, hay que leerlos como si fueran planos de metro.
Cada diagrama empieza a la izquierda y acaba a la derecha, así que simplemente sigue las líneas de principio a fin. Todas las líneas intermedias son igualmente válidas. A veces unas líneas saltan por encima de un elemento opcional, o vuelven sobre sí mismas, para indicar que ese elemento puede repetirse.
En este ejemplo, se incluye una coma entre cada iteración del elemento reiterado. El camino señalado con una coma va de derecha a izquierda y sólo puede se puede seguir pasando una primera vez por el elemento reiterado.
Los caracteres en caja redonda son literales, es decir, que se refieren a sí mismos. Un nombre en caja rectangular, por el contrario, se refiere a otro diagrama sintáctico.
Los diagramas sintácticos de la documentación de TiddlyWiki se generan con el plugin Railroad.
Este plugin proporciona un widget para la elaboración de diagramas sintácticos en forma de imágenes SVG.
La notación del diagrama puede guardarse en un tiddler exclusivo con el campo type definido como text/vnd.tiddlywiki.railroad, de forma que esté disponible para transclusión allí donde se necesite.
El plugin se basa en una librería de Tab Atkins, y se ha trabajado en ella para hacerla más flexible, lo que incluye que los componentes del diagrama actúen como enlaces o admitan transclusión de otros tiddlers.
Para más información sobre el uso de este plugin, pincha aquí
| purpose | generate a range of numbers |
|---|---|
| input | ignored |
| parameter | N = a range specification, like [1,5] |
| output | a series of evenly spaced numbers ranging from <begin> to <end> |
The range operator produces a list of numbers counting up or down. It's useful for counting and numbering, or in combination with the Formula Plugin.
| Purpose | produce a range of numbers |
|---|---|
| Input | ignored. |
| Parameter | 1-3 numbers separated by , or ;. |
| Output | A series of evenly spaced numbers ranging from <begin> to <end> |
! Output | As Output, but with order reversed. |
The parameter has three forms:
| Parameter | Output |
<end> | Whole numbers up to <end>. |
<begin>,<end> | Numbers from <begin> to <end>, spaced by whole numbers. |
<begin>,<end>,<step> | Numbers from <begin> to <end> spaced out by <step>. |
Each part must be a number, and works as follows:
<begin>: start counting at this number.- Defaults to 1 if
<end>is at least 1 (or -1 if<end>is at most -1).
- Defaults to 1 if
<end>: stop counting at this number.- This number will appear in the list unless it falls between two steps.
<step>: count up (or down) by this amount.- Defaults to 1.
- Cannot be zero.
- We always count from
<begin>toward<end>, whether<step>is positive or negative.
The number of decimal points in the output is fixed, and based on the parameter with the most decimal points.
To prevent the browser from freezing, range is currently limited to 10,000 values.
Examples
[range[7]]1 2 3 4 5 6 7
[range[1, 10]]1 2 3 4 5 6 7 8 9 10
[range[17,13]]17 16 15 14 13
[range[1.001, 5, 1]]1.001 2.001 3.001 4.001
[range[.5,1.4,.004]]0.500 0.504 0.508 0.512 0.516 0.520 0.524 0.528 0.532 0.536 0.540 0.544 0.548 0.552 0.556 0.560 0.564 0.568 0.572 0.576 0.580 0.584 0.588 0.592 0.596 0.600 0.604 0.608 0.612 0.616 0.620 0.624 0.628 0.632 0.636 0.640 0.644 0.648 0.652 0.656 0.660 0.664 0.668 0.672 0.676 0.680 0.684 0.688 0.692 0.696 0.700 0.704 0.708 0.712 0.716 0.720 0.724 0.728 0.732 0.736 0.740 0.744 0.748 0.752 0.756 0.760 0.764 0.768 0.772 0.776 0.780 0.784 0.788 0.792 0.796 0.800 0.804 0.808 0.812 0.816 0.820 0.824 0.828 0.832 0.836 0.840 0.844 0.848 0.852 0.856 0.860 0.864 0.868 0.872 0.876 0.880 0.884 0.888 0.892 0.896 0.900 0.904 0.908 0.912 0.916 0.920 0.924 0.928 0.932 0.936 0.940 0.944 0.948 0.952 0.956 0.960 0.964 0.968 0.972 0.976 0.980 0.984 0.988 0.992 0.996 1.000 1.004 1.008 1.012 1.016 1.020 1.024 1.028 1.032 1.036 1.040 1.044 1.048 1.052 1.056 1.060 1.064 1.068 1.072 1.076 1.080 1.084 1.088 1.092 1.096 1.100 1.104 1.108 1.112 1.116 1.120 1.124 1.128 1.132 1.136 1.140 1.144 1.148 1.152 1.156 1.160 1.164 1.168 1.172 1.176 1.180 1.184 1.188 1.192 1.196 1.200 1.204 1.208 1.212 1.216 1.220 1.224 1.228 1.232 1.236 1.240 1.244 1.248 1.252 1.256 1.260 1.264 1.268 1.272 1.276 1.280 1.284 1.288 1.292 1.296 1.300 1.304 1.308 1.312 1.316 1.320 1.324 1.328 1.332 1.336 1.340 1.344 1.348 1.352 1.356 1.360 1.364 1.368 1.372 1.376 1.380 1.384 1.388 1.392 1.396 1.400
Introduction
The range widget displays an HTML <input type="range"> that reflects a given tiddler field numeric value. Adjusting the range slider sets the tiddler field to the value.
Content and Attributes
The content of the <$range> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler to manipulate (defaults to the current tiddler) |
| field | The field of the tiddler bound to the range slider |
| min | The minimum value to be able to be set by the <$range> widget. |
| max | The maximum value to be able to be set by the <$range> widget. |
| increment | The minimum amount by which a value may be changed. Defaults to 1. |
| default | The default value displayed if the field is missing or empty. |
| class | CSS classes to be assigned to the label around the range slider |
Examples
Range -1 to 10
<$range tiddler="$:/_RangeDemo/1" min="-1" max="10" default="1" increment="1"/> {{$:/_RangeDemo/1}}Este es su aspecto:
Range 0 to 1
<$range tiddler="$:/_RangeDemo/2" min="0" max="1" default=".01" increment=".01"/> {{$:/_RangeDemo/2}}Este es su aspecto:
Featuring plugins that integrate two interesting new capabilities:
- SocialCalc providing a powerful spreadsheet
- Three.js providing interactive 3D graphics
I developed some plugins related to engineering tasks.
After using them for personal projects I'm glad to share with TiddlyWiki community.
Welcome to TiddlyWiki, a non-linear personal web notebook that anyone can use and keep forever, independently of any corporation.
TiddlyWiki is a complete interactive wiki in JavaScript. It can be used as a single HTML file in the browser or as a powerful Node.js application. It is highly customisable: the entire user interface is itself implemented in hackable WikiText.
Learn more and see it in action at https://tiddlywiki.com/
Developer documentation is in progress at https://tiddlywiki.com/dev/
Join the Community
Foros de discusión de TiddlyWiki.
Son listas de correo en las que hablamos de TiddlyWiki: pedimos ayuda, anunciamos la publicación de nuevas ediciones o de nuevos plugins, debatimos sobre nuevas características, o simplemente compartimos experiencias.
Puedes participar a través de la página web asociada, o suscribirte via mail.
Usuarios
No necesitas tener cuenta en Google para acceder al grupo. Suscríbete igualmente enviando un mail a:
Además, puedes participar en nuestras reuniones periódicas online
o síguenos en Twitter si quieres recibir las últimas noticias
Desarrolladores
Grupo de desarrollo de TiddlyWiki
No necesitas tener cuenta en Google para acceder al grupo. Suscríbete igualmente enviando un mail a:
Accede a nuestra página de desarrollo en GitHub y haz tu contribución.
Síguenos en Twitter si quieres estar al tanto de las últimas noticias
Las nuevas ediciones de TiddlyWiki, TiddlyDesktop y TiddlyFox se anuncian en los foros de discusión y en Twitter.
También puedes suscribirte al feed de versiones en GitHub
Installing TiddlyWiki on Node.js
- Descarga e instala Node.js desde la página oficial: http://nodejs.org
- Abre una terminal de línea de comandos y teclea:
npm install -g tiddlywiki(ver nota * más abajo)Si te da fallo, necesitas volver a ejecutar la orden como administrador:
sudo npm install -g tiddlywiki(Mac/Linux) - Comprueba que TiddlyWiki se ha instalado con el comando:
tiddlywiki --version - Si todo está bien, TiddlyWiki devolverá el número de versión (p. ej, en este caso, 5.1.21. Puede que también muestre alguna información complementaria, de depuración.
- Probemos a ponerlo en marcha:
tiddlywiki miwiki --init servercreará, en el mismo directorio en el que hayas abierto la consola, una carpeta llamada miwiki, con los componentes necesarios.tiddlywiki miwiki --serverpondrá en marcha TiddlyWiki, que podrás ver y editar en el navegador.- Abre el navegador y escribe http://127.0.0.1:8080/ (o localhost:8080) en la barra de direcciones.
- Crea y edita tiddlers del modo acostumbrado. Los cambios se guardarán automáticamente en la carpeta miwiki/tiddlers
- Para apagar TiddlyWiki, cierra el navegador y haz Ctrl-C en la línea de comandos (o ciérrala: la consola te advertirá de que al hacerlo matarás el proceso en marcha. Confirma y listo)
- # Como opción, puedes hacer una copia offline del wiki:
- Con TiddlyWiki abierto en el navegador, haz click en el botón Guardar cambios de la barra lateral
- Con TiddlyWiki apagado y desde el mismo directorio desde donde lo iniciaste, teclea el siguiente comando en la consola:
tiddlywiki --build index
Nota: El argumento
-ghace que TiddlyWiki se instale globalmente (es decir, en todo el equipo). Sin él, TiddlyWiki estará disponible únicamente en el directorio desde el que lo instales.Si usas Debian o un sistema basado en Debian y recibes un mensaje del tipo
node: command not foundpese a haber instalado node.js, puede que necesites crear un enlace simbólico entrenodejsynode. En tal caso, consulta el manual de tu distribución de Linux ywhereis(más información sobre este comando) para crearlo correctamente (ver también issue 1434 en GitHub).Ejemplo en Debian v8.0:
sudo ln -s /usr/bin/nodejs /usr/bin/node
Using TiddlyWiki on Node.js
TiddlyWiki se puede usar desde la línea de comandos para ejecutar una larga lista de operaciones basadas en carpetas, tiddlers y archivos HTML de ~Tiddlywiki.
Por ejemplo, el siguiente comando carga tiddlers de un archivo HTML de TiddlyWIki y guarda uno de ellos (ReadMe) como HTML estático (readme.html):
tiddlywiki --verbose --load mi_wiki.html --rendertiddler ReadMe ./readme.htmlEjecutar TiddlyWiki desde la línea de comandos pone en marcha el núcleo, carga los plugins y establece un "almacén" de tiddlers en blanco. A partir de entonces procesa los argumentos de la línea de comandos de izquierda a derecha. Los argumentos se separan con espacios.
El primer argumento es la ruta opcional al WikiFolder que se va a cargar. Si no se especifica, se usa el directorio actual.
Le siguen uno o varios comandos con sus respectivos argumentos. Los comandos se identifican con el prefijo --.
tiddlywiki [<ruta>] [--<comando> [<argumento>[,<argumento>]]]Los comandos disponibles son:
- build
- clearpassword
- deletetiddlers
- editions
- fetch
- help
- import
- init
- listen
- load
- makelibrary
- output
- password
- render
- rendertiddler
- rendertiddlers
- save
- savetiddler
- savetiddlers
- savewikifolder
- server
- setfield
- unpackplugin
- verbose
- version
Upgrading TiddlyWiki on Node.js
Si has instalado TiddlyWiki en Node.js de la forma habitual, puedes actualizarlo a la última versión con este comando:
npm update -g tiddlywikiEn Mac o Linux necesitas añadir "sudo":
sudo npm update -g tiddlywikiAlso see
- WikiFolders
- MultiTiddlerFileSyntax
- MultiTiddlerFiles
- TiddlerFiles
- Generating Static Sites with TiddlyWiki
- How to build a TiddlyWiki5 from individual tiddlers
- Using TiddlyWiki for GitHub project documentation
- Using a custom path prefix with the client-server edition
- Building TiddlyWikiClassic
- Customising Tiddler File Naming
- Environment Variables on Node.js
- Scripts for TiddlyWiki on Node.js
- Serving TW5 from Android
- Working with the TiddlyWiki5 repository
- Internet Information Services
This readme file was automatically generated by TiddlyWiki
Script Files
The TiddlyWiki5 repository contains several scripts in the bin folder that you can use to automate common tasks, or as a useful starting point for your own scripts. See Scripts for building tiddlywiki.com for details of the scripts used to build and release https://tiddlywiki.com/.
All the scripts expect to be run from the root folder of the repository.
serve: serves tw5.com
./bin/serve.sh -h
./bin/serve.sh [edition dir] [username] [password] [host] [port]Or:
./bin/serve.cmd -h
./bin/serve.cmd [edition dir] [username] [password] [host] [port]This script starts TiddlyWiki5 running as an HTTP server, defaulting to the content from the tw5.com-server edition. By default, the Node.js serves on port 8080. If the optional username parameter is provided, it is used for signing edits. If the password is provided then HTTP basic authentication is used. Run the script with the -h parameter to see online help.
To experiment with this configuration, run the script and then visit http://127.0.0.1:8080 in a browser.
Changes made in the browser propagate to the server over HTTP (use the browser developer console to see these requests). The server then syncs changes to the file system (and logs each change to the screen).
test: build and run tests
This script runs the test edition of TiddlyWiki on the server to perform the server-side tests and to build test.html for running the tests in the browser.
lazy: serves tw5.com with lazily loaded images
./bin/lazy.sh <username> [<password>]Or:
./bin/lazy.cmd <username> [<password>]This script serves the tw5.com-server edition content with LazyLoading applied to images.
Los siguientes temas constituyen la documentación de referencia de TiddlyWiki:
Los tiddlers de referencia ofrecen información al lector –presumiblemente de nivel intermedio o experto– de manera comprensible e interreferenciada.
Se estructura en varias subcategorías:
- Conceptos
- Definidos, juntos forman un glosario
- Manual de usuario
- Presenta aspectos técnicos de las características de WikiText
- Se subdivide en: mensajes, operadores, variables, widgets... etc
- Manual de desarrollador
- Presenta aspectos técnicos de la arquitectura interna de TiddlyWiki
El material de referencia se redacta en estilo formal que evita referirse al lector y enfoca su atención en el comportamiento de TiddlyWiki. Predomina el uso de la voz pasiva y las expresiones impersonales:
Reference material is written in a terse, formal style that avoids referring to the reader, and instead focuses on how TiddlyWiki itself behaves. The passive voice is often suitable:
- "se especifica la plantilla como tiddler" mejor que "especifica la plantilla como tiddler"
- "el widget puede servir para varios fines" mejor que "puedes usar el widget para varios fines"
- Pero "este widget tiene varios usos posibles" es aún mejor, ya que es más conciso y menos retorcido.
Al redactar en inglés, se evita el uso de formas verbales contraídas, pero aquellas que terminan en "n't", como ("aren't", "doesn't", "hasn't", "isn't"... etc, son aceptables, ya que así es menos probable que en su lectura se pase por alto el "not" de las formas no contraídas.
| purpose | filter the input by pattern-matched field |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a field, defaulting to title |
| parameter | X = a regular expression |
| output | those input tiddlers in which field F matches X |
! output | those input tiddlers in which field F does not match X |
Regular expressions are concise strings of characters that denote patterns of text to search for. The format used in TiddlyWiki is fully defined in this Mozilla reference.
The filter syntax makes it impossible to directly specify a regular expression that contains square brackets. The solution is to store the expression in a variable. See the examples.
The parameter X can optionally start or end with a string of flags:
Only the i flag is generally useful: it forces the different between capital and lowercase letters to be ignored.
If X is empty, regexp will match all of the input tiddlers.
These examples make use of the Days of the Week tiddler.
[!is[system]regexp[Wiki]]
Wiki in their title[!is[system]regexp[(?i)Wiki]]
Wiki in their title, ignoring case[!is[system]regexp[Wiki(?i)]]
[regexp[(?i)\.jpe?g$]]
.jpg or .jpeg, ignoring case[regexp:created[^201408]]
The regular expression [0-9]{2} matches two consecutive digits. Because it contains square brackets, the way to use it with the regexp operator is via a variable, as follows:
<$set name="digit-pattern" value="[0-9]{2}">
<<list-links "[regexp:title<digit-pattern>]">>
</$set>Este es su aspecto:
- TiddlyWiki European Meetup 2016
- TiddlyWiki European Meetup 2017
- TiddlyWiki extensions for Sublime Text 3 by roma0104
- "デザイン刷新。次の25年を目指すTiddlyWiki" by Moongift
- Base64
- European Meetup 2017
- 5.1.10
- 5.1.11
- 5.1.12
- 5.1.13
- 5.1.14
- 5.1.15
- 5.1.16
- 5.1.17
- 5.1.18
- 5.1.19
- 5.1.20
- 5.1.21
- 5.0.0-alpha.11
- 5.0.0-alpha.12
- 5.0.0-alpha.13
- 5.0.0-alpha.14
- 5.0.0-alpha.15
- 5.0.0-alpha.16
- 5.0.0-alpha.17
- Notes for upgrading to 5.0.11-beta
- 5.0.10-beta
- 5.0.11-beta
- 5.0.12-beta
- 5.0.13-beta
- 5.0.14-beta
- 5.0.15-beta
- 5.0.16-beta
- 5.0.17-beta
- 5.0.18-beta
- $:/state/tab/sidebar--1835078512
This release is the culmination of a large scale refactoring of the widget mechanism of TiddlyWiki5. There are several changes to be aware of if upgrading from earlier versions:
- The following widgets have been removed:
<$setstyle>- use<div style=<<macroName Param>>>instead<$video>- will return in a later release<$datauri>- use the<<makedatauri>>built-in macro instead<$error>- may return in a later release<$import>- use the BrowseWidget, DropzoneWidget and NavigatorWidget instead<$info>- use the<<changecount>>built-in macro instead<$version>- use the<<version>>built-in macro instead
- The following widgets have had significant changes:
- EditWidget
- ListWidget - the list widget itself no longer generates HTML nodes, so you'll often need to wrap the template in a
<div>or a<span>to be able to style the content - ViewWidget - has several changes:
<$view format="link"/>is no longer available; use an explicit<$link>widget instead<$view format="link"/>is no longer available; use the TranscludeWidget instead
- The following new widgets have been added:
- Widget attribute names have been made more consistent. In particular,
tiddleris used to reference a tiddler by title, nottitle - It is no longer possible to import the macro definitions within another tiddler by transcluding that tiddler
- The
bodyelement now has the classtw-body, which will need to be specified in any overrides- This was done due to the new support for HTML foreign objects, which makes it possible to have multiple
<body>elements in a document
- This was done due to the new support for HTML foreign objects, which makes it possible to have multiple
See GitHub for detailed change history of this release
This minor release just contains fixes for the syncer and related adaptor modules for the TiddlyWeb edition and for TiddlyWiki5's integrated server.
See GitHub for detailed change history of this release
This release has several bug fixes:
- Fixes to DaveGifford's themes blanca, blue and rocker
- Fix an issue with the
<$edit-text>widget - Documentation updates
- Improved deployment scripts
- Made the modifier field in the subtitle be a link
- Styling improvements for the CodeMirror plugin
- Improved the ViewWidget so that it falls back to displaying its content if the field/property is missing or empty
- Extend use of the built-in
<<tabs>>macro to the tiddler info panel, the control panel and the sidebar- This means that you can add new tabs by creating tiddlers with these tags, and optionally a
captionfield for the text of the tab:- $:/tags/TiddlerInfo for tiddler info panel tabs
- $:/tags/ControlPanel for control panel tabs
- $:/tags/SideBar for sidebar tabs
- $:/tags/MoreSideBar for tabs in the "more" sidebar
- Change the order of tabs by adjusting the
listfield of the corresponding tag tiddler
- This means that you can add new tabs by creating tiddlers with these tags, and optionally a
See GitHub for detailed change history of this release
This release has several bug fixes:
- Improved the layout of the control panel
- Fixed problem with using the CheckboxWidget to apply tags to tiddlers that don't have any existing tags
- Fixed problem with default password for the PasswordWidget being the string "null"
See GitHub for detailed change history of this release
New Features
- Added a dropdown to the edit template for setting the tiddler type
- A saver module for Microsoft Internet Explorer version 10 and above. Clicking save in the sidebar causes the browser to pull up a bar at the bottom of the window where you can click save. You then get a new copy of your wiki in the downloads folder.
- Support for new
tw-close-other-tiddlersmessage (eg, ) - For http://five.tiddlywiki.com, add a tiddler info tab with a link to the static representation of the tiddler
- Make more UI elements extensible via system tags:
- $:/tags/ViewToolbar for the view mode tiddler toolbar
- $:/tags/EditTemplate for the edit template
- $:/tags/EditToolbar for the edit mode tiddler toolbar
- $:/tags/PageControls for the page control tools in the sidebar
Improvements
- Rename the
<$setvariable>to<$set><$setvariable>will temporarily remain as a synonym for<$set>for the next few releases
- Improve the popup mechanism so that the tiddler info panel doesn't close so easily
- Various improvements for working with TiddlyWeb, including:
- Updated control panel
Bug fixes
- Fixed bug when creating a tiddler title starting or ending with a space
- Fixed behaviour of tags editor dropdown when search box is empty
- Fixed problem with interpretation of
fieldsandindexattributes of the TranscludeWidget - Fixed the module type names in the internal tab of the control panel
- Improved styling for embedded PDFs
- Fixed bug with second being omitted from serialised date formats
Contributors to this release include @jermolene and @grayeul.
See GitHub for detailed change history of this release
New Features and Improvements
- Improved appearance of tags editor
- Improved generation of qualified tiddler titles for state storage
- Instead of
$:/state/tab/sidebar-{$:/core/ui/SideBar|$:/core/ui/SideBar||}{$:/core/ui/PageTemplate|$:/core/ui/PageTemplate||}one gets$:/state/tab/sidebar-{1743827719}
- Instead of
- Significant updates to the structure and content of the user documentation
- Added a new plugin for displaying corner ribbons; currently used for a version banner on tw5.com
- Split Snow White theme into a base Vanilla theme with all the basic formatting, leaving the decorative bits to Snow White
- Existing TiddlyWikiFolders will need updating to include Vanilla as an additional theme
- The page building blocks are now driven by the system tag
$:/tags/PageTemplate- $:/TopSideBar and $:/LeftSideBar are no longer specially treated; use the new tag instead
- Fixed problem that prevented tag configured items from shadow tiddlers interleaving with items from ordinary tiddlers
- Refactored control panel to add Saving tab that includes TiddlySpot options
- Improved notifications when saving to TiddlySpot
- Added backup URL to TiddlySpot control panel tab
- Extended the ServerCommand to add primitive support for basic authentication when running under Node.js
Bug fixes
- Fixed problem with displaying tiddler titles that contain WikiText syntax
- No longer crashes when encountering an error in a filter string
- Fixed a crash when dragging and dropping tiddlers within TiddlyWiki5
- No longer update the modified date for imported tiddlers
- Automatically forces new field names to be lower case
Internal changes
- Added Windows-compatible build scripts
- Changes to the SavingMechanism to allow the tiddlers that are saved to be selected
- This enables the wiki at http://five.tiddlywiki.com/index.html to generate an empty wiki
- The main HTML file template used for saving TiddlyWiki5 documents has changed from
$:/core/templates/tiddlywiki5.template.htmlto$:/core/save/all - Moved tw5.com's Google Analytics integration into a proper plugin
Contributors to this release include @jermolene, @asampal and @pmario.
See GitHub for detailed change history of this release
Bug fixes
- Fixes a small but important bug that prevented downloading an empty wiki with alpha.16
See GitHub for detailed change history of this release
Improvements
- Changes to the importing process to enable a smoother Upgrading process
- Ignores attempts to import plugins that are older than currently installed plugins
- System tiddlers are now imported as usual
- If
$:/themeisn't defined or refers to a missing tiddler, then fallback through Snow White to Vanilla. This means thatempty.htmlnow defaults to Snow White - Added support for Block Quotes in WikiText
- Contributed by StephanHradek (@Skeeve on GitHub)
Bug fixes
- Fixed bug that was preventing
$:/tags/PageControlstiddlers from being reordered
Internal changes
- Changed the TiddlyWiki5 Versioning policy
- Beta releases will be
5.0.x-betaand the final release will be5.1.x
- Beta releases will be
See GitHub for detailed change history of this release
Highlights
- Added new syntax for Images in WikiText and a new ImageWidget
- Added support for a SafeMode that disables customisations
Documentation Improvements
- Added DateFormat documentation
Usability Improvements
- Refactor sorting to respect accented characters
- Support embedded images in Markdown tiddlers
- Refactored sidebar hiding action so that the story river border is maintained
Hackability Improvements
Bug Fixes
- Added support for saving changes on Windows network drives
- Refactored configuration processing so that ordinary tiddlers are processed after shadow tiddlers. This resolves an issue whereby user stylesheets were being overridden by shadow stylesheets
- Fixed issue with offline snapshot of server edition erroneously including shadow tiddlers
- Fixed problem with corrupted upgrades from 5.0.x-prerelease to 5.0.x-beta
- Fixed bug with
[untagged[]]filter operator - Fixed incorrect background colour for tag pills in the sidebar
- Fixed issues with null fields under TiddlyWeb
- Fixed problem with hamburger overlapping scrollbars
See GitHub for detailed change history of this release
Incompatible Changes
See Notes for upgrading to 5.0.11-beta for more details of these changes:
- The default output location for command line operations has changed to the
/outputfolder within TiddlyWikiFolders (it used to be current directory) - Note that the shadow tiddler $:/core/ui/PageMacros has changed with this release. If you've made modifications to it you should copy your modifications to a new tiddler, delete $:/core/ui/PageMacros, perform the upgrade and then manually update the new copy of $:/core/ui/PageMacros
Documentation Improvements
- Added more warnings about taking care to backup your data
Usability Improvements
- Many performance optimisations, particularly for filter operations
- Added support for PermaLinks and browser back and forward buttons
- Added support for WikiLinks in Markdown via
[link text](#TiddlerTitle) - Added support for explicit external Linking in WikiText (eg
[ext[tooltip|url]]) - Replaced hamburger menu icon with double chevron icon
- Enhance plain text parsing to use the CodeBlockWidget, and hence use syntax highlighting if the plugin is installed. This gives us syntax highlighting for JavaScript shadow tiddlers, amongst other things
- Improvements to the German, French, Italian, Japanese and Chinese translations
- Removed WikiText tiddlers from the sidebar "Types" tab
- Added various warnings when editing shadow tiddlers
- Allow digits in field names
- Added warning banner and when attempting to edit binary tiddlers
- Added automatic refreshing of the browser window title from $:/core/wiki/title
Hackability Improvements
- Improved vertical layouts of
tabsmacro - Added "standard" tab to advanced search
- Added new filter operators
beforeandafter - Added new
getoperator - Added BuildCommand, OutputCommand and ClearPasswordCommand
- Added new extensible StartupMechanism for orchestrating startup tasks
- Updated to new version of CodeMirror
- Added https://github.com/Jermolene/TiddlyWiki5NodeWebkit, a demo of using TiddlyWiki as a library in a node-webkit application
- Extended
.tidTiddlerFiles to allow single line text fields - Renamed
$:/ShowEditPreviewto$:/state/showeditpreview
Bug Fixes
- Fixed issue with hovering of the topbar icons in Firefox
- Fixed problem with dragging and dropping within a text edit control
Contributors
I (@Jermolene) would like to thank the contributors to this release who have generously given their time to helping improve TiddlyWiki:
@BramChen, @mwfogleman, @nameanyone, @natecain, @pekopeko1, @pmario, @sukima, @xcazin.
See GitHub for detailed change history of this release
This is an emergency release that fixes a single significant bug with shadow tiddler handling in 5.0.11. See the discussion thread for more details.
See GitHub for detailed change history of this release
Accessibility Improvements
This release includes a number of features designed to improve the experience of TiddlyWiki with a screen reader. Particular thanks to @domasofan for his feedback
- Added label and title for show/hide sidebar buttons
- Added label and title for advanced search link
- Added label and title for close buttons in "Open" sidebar tab
- Added aria-label support to the LinkWidget
- Switched to H1 tags for the page title and H2 tags for tiddler titles
- Added label and title for tiddler and page toolbar buttons
Usability Improvements
- Added support for global Macros in WikiText via the new ImportVariablesWidget
- Added new SelectWidget
- Improved behaviour of
text/htmltiddlers so that they are displayed within an HTML iframe element - Added group headings to the content type dropdown in edit mode
- Improved advanced navigation settings in $:/ControlPanel to use radio buttons
- Improved (and here) behaviour of PermaLinks so that now https://tiddlywiki.com/#HelloThere just opens the single specified tiddler
- Added support for triple-quoted multi-line attributes with macros, widgets and HTML elements
- Added TableOfContents tab for tw5.com edition
Hackability Improvements
- Restored escape as a shortcut to abandon edits
- Added support for ExternalImages that are referenced by URI and not stored in the TiddlyWiki HTML file
- Added new SetFieldCommand
- Added new SaveTiddlersCommand
- Added support for system tag $:/tags/RawMarkup
- Added editor type mappings to control panel advanced tab
- Refactored CodeMirror (https://tiddlywiki.com/codemirrordemo.html) plugin for simpler configuration
- Added support for Environment Variables on Node.js
- Extended ServerCommand to allow a path prefix
- Extended the
listedoperator to use any list field
Bug Fixes
- Fixed here and here the problem with state tiddlers being inadvertently saved
- Fixed bug with TextWidget not refreshing correctly
- Fixed problem with vertical tabs in Safari
- Fixed issue with images in Markdown
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Major Changes
Improved Control Panel Plugins Tab
The Plugins tab of the control panel has been improved with the addition of documentation tabs that plugins can use to show documentation. There is also a larger draggable area for dragging tiddlers across to other wikis.
Configurable Button Toolbars
The page toolbar and the tiddler toolbars can now be configured with several new buttons - see the control panel under the Appearance and Toolbars tabs.
The sidebar tools tab now shows all the available page controls, allowing them to be invoked or checked to appear in the toolbar. The tiddler info area now includes a tools tab that includes buttons for all the tiddler actions.
Upgrade Mechanism
There are two components:
- A more flexible ImportMechanism that:
- Presents incoming tiddlers as a pending import list that allows the user to inspect them and, if necessary, explicitly deselect them from the actual import
- Provides UpgraderModules with an opportunity to process each incoming tiddler
- The plugin upgrader module handles version checking of plugins and upgrading them from a special UpgradeLibrary plugin tiddler
- The system upgrader module is responsible for suppressing the importing of certain system tiddlers (currently $:/StoryList and $:/HistoryList)
- The themetweak upgrader module handles migrating theme tweaks from their pre-5.0.14-beta format (see below)
- An UpgradePlugin and associated edition that provides a custom, single-purpose user interface for upgrading standalone TiddlyWiki files - see https://tiddlywiki.com/upgrade.html
Improvements to CamelCase Recognition
TiddlyWiki now takes a much more conservative approach to recognising CamelCase terms that should be automatically linked. Previously, the dash and underscore were treated as lower case letters, leading to a number of false positives. See the GitHub bug #337 for details.
Automatic Permalinking Off by Default
With previous beta releases of TiddlyWiki the browser address bar is automatically updated so that it dynamically reflects the tiddlers that are currently open. This makes it easier to get a permalink for copying and pasting elsewhere, but it leads to much confusion for casual users who don't always understand why unexpected tiddlers are being displayed after they have refreshed the page in the browser.
For 5.0.14-beta, the setting has been changed. Visit control panel Advanced/Settings to switch the setting back to "Include the target tiddler and the current story sequence".
Usability Improvements
- Added previews to the icon dropdown in the tag manager
- Added an indication of unsaved changes by changing the colour of the save changes button
- Split the wikitext emphasis parsers into separate modules so that they can be independently controlled with the
\rulespragma - Refactored (and here) ReleaseHistory to place the releases into vertical tabs
- Stopped saving $:/HistoryList, thus avoiding it uncontrollably increasing in size
- Improved (and here) print stylesheet to remove page background
- Updated display of plugin tiddlers so that their constituent tiddlers are shown, rather than the raw JSON
- Moved the functionality of the fullscreen plugin into the core
Hackability Improvements
- Extended TiddlerWidget to add a CSS class corresponding to each tag present on displayed tiddlers
- Added support for hiding specified fields in the tiddler editor
- Added support for variable operands in filters (see Filter Parameter)
- Added support for widget messages tw-permalink and tw-permaview
- Added browser sniffing plugin so that tiddlywiki.com can present the correct browser-specific documentation
- Added a configuration option for specifying the default location for saving new tiddlers in the client-server configuration
- Added support for the InfoMechanism
- Extended CheckboxWidget to allow it to toggle fields as well as tags
- Refactored control panel theme tweaks to be stored in individual tiddlers
- Extend the
tabsmacro to allow tabs to be templated - Added (and here) SystemTags support for inserting content above and below the story river
- Added support for transcluding plugin subtiddlers with the TranscludeWidget
- Added (and here) support for importing from
*.htmand*.htafiles as well as the existing support for*.htmlfiles - Extended the "sticky titles" theme so that it works when tiddlers are in edit mode
Bug Fixes
- Fixed bug with execution order of BuildCommand targets
- Fixed bug with missing hover colours for external links
- Fixed problem with refreshing modal dialogues
- Fixed issue with cookies disabled on Firefox
- Relax the requirement for a newline immediately the closing
\endof a macro definition
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Usability Improvements
- Simplified shadow default tiddlers
- Added the ability to disable plugins (see PluginMechanism) with a user interface in control panel
- Added page control button for invoking the tag manager
- Simplified downloading an offline copy of a client-server wiki
- Blocked temporary state tiddlers from import/upgrade
Hackability Improvements
- Added a banner to the edit template encouraging improvements to the documentation
- Refactored
saver-handler.jsout ofsyncer.js - Added Table-of-Contents Macros
- Simplified startup module organisation (see Startup Modules.svg)
- Changed the overlay text for the DropzoneWidget to make it translateable
- Introduced a new refresh button and reverted home button behaviour
- Added alt attribute to the ImageWidget
Bug Fixes
- Fixed problem with building TiddlyWiki under Windows
- Fixed unclickable download ink in upgrade wizard
- Fixed missing language flag in empty.html
- Fixed problem with switching the type of a tiddler between the bitmap and text editor
- Fixed foreground colour for tag pills in the sidebar
- Fixed problem with github source links for tiddlywiki.com not working for titles containing colons
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Incompatible Changes
5.0.16-beta brings more incompatible changes than any previous release. These changes are likely to break almost all plugins written for previous releases of TiddlyWiki 5, and will break many customisations.
- Changed all CSS class prefixes from
tw-totc-(egtw-tiddler-framehas becometc-tiddler-frame; missing prefixes have also been added, sobtn-invisiblehas becometc-btn-invisible) - Changed all message prefixes from
tw-totm-(egtw-close-tiddlerhas becometm-close-tiddler) - Changed all variable prefixes from
tw-totv-(egtw-config-toolbar-iconshas becometv-config-toolbar-icons) - Changed prefix/removeprefix filter operators to be case-sensitive
Compatibility with TiddlyWikiClassic
This release includes a preliminary version of a new plugin that provides compatibility with content created for TiddlyWikiClassic:
https://tiddlywiki.com/classicparserdemo.html
Subsequent releases will include end-user documentation with step-by-step instructions for migrating content.
Many thanks to @buggyj for his work on this plugin.
Usability Improvements
- Amended behaviour of the tm-browser-refresh message so that it no longer clears the location hash
- Hide toolbar buttons from static renderings
Hackability Improvements
- Extend the
alloperator to be able to select all the source tiddlers - Fixed problem with single line macro definitions incorrectly including whitespace in the value. (For example,
\define mymacro() yeswould set the macro value to " yes", with a leading space) - Extend Table-of-Contents Macros use the caption field if present
- Configurability for the default tab shown in the tiddler info panel (see Configuring the default TiddlerInfo tab)
- Added
suffixandremovesuffixoperators
Bug Fixes
- Reverted incorrect refreshing of the tiddler widget
- Fixed indentation of selective expandable Table-of-Contents Macros
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Highlights
This release includes major improvements from @giffmex to the welcome and tutorial documentation, and new development docs incorporating the work of @cheigele and @cjrk.
Incompatible Changes
Change System Tag $:/tags/stylesheet with $:/tags/Stylesheet
The issue is that the capitalisation of $:/tags/stylesheet is not consistent with other system tags. This release adds support for $:/tags/Stylesheet, and adds a deprecation warning if $:/tags/stylesheet is used. Support for $:/tags/stylesheet will be removed before the beta.
- Added support for
$:/tags/Stylesheetand a deprecation warning when$:/tags/stylesheetis used
Change ButtonWidget title attribute to tooltip
The use of the title attribute in the ButtonWidget was not consistent with the tooltip attribute used by the ImageWidget and LinkWidget. This release adds support for the tooltip attribute to the ButtonWidget alongside the existing support for the title attribute, but with a deprecation warning.
- Added
tooltipattribute to ButtonWidget
Removing Support for RegExp Filter Operands
As discussed in the associated ticket, the support for regular expression filter operands is incomplete and inconsistent. The plan is to remove support for this feature in the next release. A new filter operator has been provided to replace it, along with the addition of a deprecation warning that is displayed whenever regular expression filter operators are used.
Repository Reorganisation
The goal is to make the TiddlyWiki repository easier to comprehend for newcomers.
- Moved scripts into a separate
binfolder
Usability Improvements
- Reorganised the control panel to make it more logical and usable
Hackability Improvements
- Moved developer documentation to https://tiddlywiki.com/dev
- Improvements (and here) to
serve.sh/serve.cmdscripts - Disable plugins when in SafeMode
- Added new
timelinemacro - Added new
dumpvariablesmacro - Extended Table-of-Contents Macros so that individual links can be disabled
- Removed (and here) unnecessary
<p>tag from edit tags and types dropdowns - Added multiple attribute to the BrowseWidget
- Extended view template to hide bodies of tiddlers with field hide-body set to yes
Bug Fixes
- Fixed problem with draft tiddlers not counting as dirty
- Fixed problem with keyboard shortcuts introduced in 5.0.16-beta
- Fixed problem with stylesheets being parsed in inline mode
- Fixed bug with selective expandable Table-of-Contents Macros
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a minor release prior to the full release of TiddlyWiki on September 20th. The documentation has been cleaned up and improved (with more improvements to come).
File Layout of tiddlywiki.com
The layout of files on tiddlywiki.com has been adjusted to make it more logical. See the ticket for a discussion. You can see the source files that make up tiddlywiki.com at https://github.com/Jermolene/jermolene.github.com
Hackability Improvements
- Added first iteration of a
list-linksmacro (further improvements are planned) - Added support for importing
.markdownand.mdfiles - Extended
timelinemacro to support a subfilter
Bug Fixes
- Fixed problem with digits being classified as lower case letters for wiki link matching
- Fixed crash when sorting missing tiddlers by fields other than title
- Fixed problem with handling
.jpegfile extensions - Fixed problem with RadioWidget and missing tiddlers
- Fixed problem with dragging a partially selected link
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Improvements
- Added support for Hard Linebreaks in WikiText
- Added a new RadioWidget, contributed by StephanHradek (@Skeeve on GitHub)
- Two new savers for InternetExplorer, both contributed by DavidJade (@davidjade on GitHub)
- tiddlyie for saving with TiddlyIE, an equivalent of TiddlyFox for InternetExplorer
- fsosaver that can save changes directly with InternetExplorer but requires the HTML file to be renamed
*.hta
Bug fixes
- Fixed problem deleting tiddlers under the filesystemadaptor
- Fixed problem with transcluding fields containing lists or dates (eg,
{{!!tags}}) - Fixed problem with re-ordering page control tiddlers (ie tiddlers tagged
$:/tags/PageControls) - Update template used for deploying to TiddlyWeb
- Fixed problem with tiddler deletions via the file system adaptor
Internal changes
- Allowed variable number of arguments to JavaScript Macros
- Contributed by StephanHradek (@Skeeve on GitHub)
- Changed the format of plugin tiddlers to remove duplicated information (see the PluginMechanism)
See GitHub for detailed change history of this release
This release includes minor bug fixes and documentation updates.
See GitHub for detailed change history of this release
Improvements
- Switched to using an HTML5 placeholder for the default text of a new tiddler
- Refactored stylesheet handling so that theme tweaks are now applied immediately, and some ordering issues have been resolved
- Several improvements for running TiddlyWiki on Node.js:
- The
tiddlywiki.infofile in the root of wiki folder file is now optional, falling back to a default configuration suitable for serverside use (commit) - The file system plugin now automatically creates the
tiddlerssubfolder in the wiki folder
- The
- Added favicon.ico support
- Added SaveTiddlerCommand
Bug Fixes
- Fixed problem with tiddlers sometimes wrongly opening at the top of the story (commit)
- Fixed problem with refreshing RadioWidget
- Fixed problem with the dragger image being visible in some circumstances
- Fixed drag and drop support on InternetExplorer, contributed by DavidJade (@davidjade on GitHub)
- Fixed crash on modifying page template (commit)
- Updated fullscreen plugin to latest version of the API (commit)
- Improved handling of double square brackets within tags (thanks to StephanHradek)
This release includes minor bug fixes and documentation updates.
See GitHub for detailed change history of this release
Improvements
- Added support for Setting a favicon
Bug Fixes
- Fixed problem with modal wizard positioning on narrow screens
- Fix problem with static content being included in empty.html when downloaded from the full wiki
- Improved performance of tiddler import with large tiddlers on Firefox
See GitHub for detailed change history of this release
Improvements
- Added support for numeric sorting to TiddlerFilters (thanks to StephanHradek)
- Extended Tables in WikiText to allow for vertical alignment of cells (thanks to StephanHradek)
- Added experimental support for running TiddlyWiki on node-webkit
- Added an $:/AdvancedSearch
- Added support for specifying hostname for the ServerCommand
- Added a first pass at generating an all-in-one static HTML representation of a wiki, complete with internal anchor links for wiki links
- Hide encryption features when running on the server
- Added double backticks as an alternative for delimitting inline code (thanks to StephanHradek)
Bug Fixes
- Fixed import browse button
- Fixed crash when attempting full screen mode on browsers that don't support it
- Fixed requirement for a newline immediately after a horizontal rule, table or typed block (thanks to StephanHradek)
- Fixed problem with placeholder attibute on InternetExplorer (thanks to DavidJade)
See GitHub for detailed change history of this release
Incompatible Changes
These are changes that might affect users upgrading from previous betas.
- The node-webkit saver has been moved into a plugin - $:/plugins/tiddlywiki/nodewebkitsaver. The plugin is only needed when embedding a single TiddlyWiki in node-webkit and is not required for TiddlyDesktop, which as of v.0.0.2 uses the existing TiddlyFox saver.
Documentation updates
- A new video tutorial: TiddlyWiki on Firefox for Android Video
- A first pass at TiddlyWiki Coding Style Guidelines
- Added an explanation of TemplateTiddlers
- Added documentation for saving on a custom PHP server
- Added documentation for TextWidget
- Summary of the approach for Naming of System Tiddlers
Improvements
- Added support for importing encrypted TiddlyWiki documents
- Added several new filter operators, including reverse, first, last, butlast, rest, nth
- Extend list filter operator to allow other fields to be used via a TextReference
- Added shortcut in $:/ControlPanel Basics tab for setting $:/DefaultTiddlers to retain tiddler story ordering
- Added emacs and vim keymapping support to the CodeMirror plugin, (thanks to João Bolila, @jbolila on GitHub)
- Added the highlight.js syntax highlighting plugin: https://tiddlywiki.com/highlightdemo.html (thanks to João Bolila, @jbolila on GitHub)
- Added the first export option to the Tools tab of the control panel
- Added an ellipsis for advanced search next to the search box in the sidebar
- Adjusted the password dialogue to make it narrower for smaller screens
- Adjusted the display of tiddler dictionaries to make them display as plain text
Bug Fixes
- Fixed problem with default format of ViewWidget substituting seconds for minutes in displayed times
- Fixed problem that was causing several animations to fail in Safari
- Fixed problem with unclickable sidebar under the Centralised theme
- Fixed problem with non-system tiddlers showing up in system tiddler advanced search
- Fixed problem with notifications not always disappearing in Firefox
- Fixed problem with wiki folders including wiki files with tiddlers that do not have a title
- Fixed problem with ServerCommand logging "Serving on undefined:8080"
See GitHub for detailed change history of this release
Incompatible Changes
See Notes for upgrading to 5.0.8-beta for more details of these changes:
- Changed rules for parsing content of HTML elements
- Switched SiteTitle and SiteSubtitle to $:/SiteTitle and $:/SiteSubtitle
- Changes to commands used with TiddlyWiki on Node.js
- Changes to naming of some editions
- Notably clientserver has changed to server
Documentation Improvements
- Improved documentation for TiddlerFilters, including a notation of the TiddlerFilter Formal Grammar contributed by @Tikkoneus
- Improved documentation for WidgetMessages
- Tiddlers on tiddlywiki.com now have a link to the original source on GitHub for pull requests (see the "Sources" tab of the tiddler info panel)
Usability Improvements
- Added automatic saving on editing a tiddler and a warning when attempting to close the window with unsaved changes
- Added confirmation dialogue when deleting tiddlers
- Add support for switchable (and editable) ColourPalettes
- Added TranslationMechanism and translations for:
- Deutsch (Österreich and Deutschland) by @pmario
- Français (France) by @xcazin
- Chinese (Simplified and Traditional) by @BramChen
- Add error alerts when syncing to a server
- Rejigged $:/ControlPanel to use nested tabs
- Added $:/TagManager for easy management of tags
- Added experimental KeyboardWidget, including support for ctrl-enter (or cmd-enter) to finish editing a tiddler
- Added number of tags to control panel Basics tab
- Enhanced link handling so that control/command clicking a link opens the target tiddler without navigating to it
- Importing tiddlers via drag and drop no longer opens all the tiddlers
Scalability Improvements
- Added support for LazyLoading of images
- Extended RevealWidget to allow control over content retention
Hackability Improvements
- Added HelpCommand and InitCommand for TiddlyWiki on Node.js
- Extended ButtonWidget to allow navigating to a tiddler
- Added experimental support for building plugins in the browser: How to create plugins in the browser
- Extend the TranscludeWidget to display its content as a fallback if the tiddler or field is missing
- Add logging and AlertMechanism
- Added a Filter tab to advanced search
- Add indexes filter operator
- Control over line width and colour for EditBitmapWidget
- Add support for
.multidsMultiTiddlerFiles - Extend ViewWidget so that it works with indexes
- Added support for Tank, a new service built on TiddlyWeb: https://tank.peermore.com
- Extend relative dates to work in the future
Bug Fixes
- Fixed problem with pasting items into the browser
- Fixed problem with colour pickers not showing correct colour in Chrome
- Fixed problem with tag pills not working inside table cells
- Fixed problem in client server configuration with % in tiddler titles
- Fixed problem with not using placeholder text when editing missing tiddlers
- Fixed problem with test data in certain time zones
- Fixed problem with non-breaking space characters being converted into '@' symbols
- Fixed problem with highlighting plugin only working in the browser
- Fixed crash when wiki/themes folder contains files that are not themes
See GitHub for detailed change history of this release
Highlights
- Improved layout, including a hamburger icon for dismissing the sidebar and expanding the story river to fill the space
- Added new Seamless theme
- New Filter tab in $:/AdvancedSearch
- Initial implementation of CecilyView
- Overhaul of inconsistencies in TiddlerFilters (see Changes to filters in 5.0.9-beta)
- New translations for Italian and Japanese
- Performance improvements, particularly during editing
Documentation Improvements
- Improved and reorganised documentation for TiddlerFilters
- Demo of Making curved text with SVG
- Community links are now broken up into individual tiddlers
- Added overview diagram of TiddlyWiki Architecture
- Added documentation from buggyj: Developing plugins using Node.js and GitHub
Usability Improvements
- Made the dropdown arrow icon skinnier
- Added validation of legal characters for fieldnames
- Added blacklisting of unsafe HTML elements and attributes
- Added a warning indicator to tiddlers in TiddlyWikiClassic format
- Add tiddler info Advanced panel with information about plugins and shadow tiddlers
- Improved layout of $:/ControlPanel Plugins tab
- Enhance viewing of system tiddlers by fading down the
$:/prefix - Extend $:/TagManager to allow icons to be assigned to tags
- Added support for
list-beforeandlist-afterfields for controlling tag ordering (see TiddlerTags for details) - Added request for confirmation before abandoning edits to a tiddler
Hackability Improvements
- Updated Transclusion in WikiText syntax to allow translusion of a template without affecting the current tiddler
- Added
sourceURLhandling toeval()so that tiddler modules can be properly debugged in Chrome - New ScrollableWidget giving better control over scrollable regions
- Added new CSS class
tw-site-titlefor the site title - Disable the TiddlyWeb sync adaptor unless the wiki is loaded over HTTP
- Added a high resolution timer mechanism and a performance measurement mechanism
- Added a basic CSV parser
- Several measures to enforce the TiddlyWiki programming model:
- Extend the ButtonWidget to be able to set text references
- Add a class to tiddler frames in view mode
- Added support for WidgetMessage: tw-home
- Hidden system tags from the sidebar Tags tab
- Allow pasting and import of HTML content
- Add support for a tooltip on the LinkWidget
Bug Fixes
See GitHub for detailed change history of this release
This is the first full release of TiddlyWiki. Documentation updates made up the bulk of the changes since the previous 5.0.18-beta release.
Hackability Improvements
- Removed curly braces from qualified identifiers
Bug Fixes
- Fixed problem with Markdown Maruku mode metadata
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a minor bug fix release to improve the documentation and correct some issues with the first full release of TiddlyWiki.
Incompatible Changes
Certain features that were deprecated in Release 5.0.17-beta have now been removed:
- Removed deprecated
titleattribute on the ButtonWidget - Removed support for deprecated
$:/tags/stylesheetsystem tag
Note that the next release will also remove support for regular expression filter operands, which was also deprecated in 5.0.17-beta.
Hackability Improvements
- Added first implementation of the KaTeX Plugin for mathematical typesetting
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Major Improvements
Performance Optimisations
This release includes several low-level performance optimisations that should improve speed and responsiveness in many common operations.
- Caching the results of parsing a tiddler
- Loop optimisations
- Tiddler iteration optimisations
- State qualifier generation
- Caching data tiddlers
- Removed expensive visual effects
There is a new setting in the control panel to enable performance instrumentation, making it much easier to measure and improve performance issues.
New Editions
Three new editions of TiddlyWiki are included in this release. These can be used as starting points for creating your own wiki for several purposes:
- The Résumé Builder Edition by @inmysocks is a custom edition to guide you through the process of using TiddlyWiki to create a good looking résumé (or curriculum vitæ)
- The Blog Edition provides tools for using TiddlyWiki under Node.js to create a static HTML blog that can be published on GitHub pages (or similar)
- The Text-Slicer Edition is a custom edition with tools to help advanced users slice longer texts up into individual tiddlers.
External Text Tiddlers
Limited support for tiddlers stored in external .tid files:
- standalone TiddlyWiki HTML files with external text tiddlers can be built under Node.js
- wikis with external text tiddlers can be worked with in the browser, automatically lazily loading the content of external text tiddlers when it is first referenced
- saving changes in the browser doesn't work as expected: if edited, the external text tiddler is replaced with an ordinary tiddler
- lazy loading of external text tiddlers doesn't work in Chrome when viewing the TiddlyWiki HTML file on a file: URI; it works OK in Firefox
- lazy loading works on an HTTP URI on all browsers as long as the target file is either stored on the same domain or is served by a server that supports CORS
See Alice in Wonderland for an example. Try opening it without a network connection.
New "Tight" Theme
A new theme called "Tight" uses reduced padding, margins and font-sizes to pack as much text as possible:
Other Improvements
Translation Improvements
- Added Swedish translation by @Superdos
- Added Korean (Korean Republic) translation by @araname
- Improved Catalan, Chinese, Danish, Dutch, French, German, Italian, Russian and Spanish translations
Usability Improvements
- Enhanced the tiddler editor to accept new fields and tags when clicking confirm, without having to click "Add tag" or "Add field"
- Added new fold and fold others buttons to the tiddler toolbar to temporarily hide the body of a tiddler, and also added new fold all and unfold all page buttons
- Added ability to disable individual WikiText parser rules (see the Advanced tab of $:/ControlPanel). Also added a simple setting for disabling automatic linking of CamelCase words
- Extended support for automatically linked system tiddler titles to include digits and underscore
- Added warning when trying to use plugins designed for TiddlyWiki Classic
- Upgraded to version v8.8.0 of highlight.js for the Highlight Plugin
- Removed the need to manually confirm deleting alerts
- Added optional tooltips to tabs Macro
Hackability Improvements
- Updated to KaTeX v0.5.1, with several new features
- Added
publishFilterto default save template - Allow delete button to be used in the tiddler view-mode toolbar
- Added a new hidden setting for keyboard shortcuts
- Update ActionSetFieldWidget to allow timestamp to be preserved
- Added option to suppress navigation for edit/cancel/save
- Enhance SaveTiddlersCommand with do not delete option
- Enhance RenderTiddlerCommand with template option
- Extend tm-open-window to pass variables
- Added new utility method
$tw.utils.tagToCssSelector(tagName)for converting tag titles into a form suitable for matching thetc-tagged-*classes generated by TiddlyWiki - Added support for tiddlers containing mp4 videos
- Extended the ActionSetFieldWidget to enable it to be used to delete a field or indexed property
- Made the tw5.com documentation available as a plugin and an edition, simplifying some scenarios for re-using it
- Improved rendering of "More" sidebar tab gradients in the "Snow White" theme
- Added option in control panel to enable the display of detailed performance instrumentation in the browser developer console
- Added a LazyLoading template for all non-system tiddlers
- Improved handling of TiddlerLinks in Markdown tiddlers
- Extended FieldManglerWidget to create the target tiddler if it does not exist
- Extended KeyboardWidget to trigger ActionWidgets
- Extended SelectWidget to support multiple selections
- Added new days Operator
- Added official plugin wrappers for the JavaScript libraries async.js and JSZip
- Added new ActionListopsWidget
- Added rows attribute to EditTextWidget
Bug Fixes
- Fixed problem introduced in 5.1.9 with processing
tiddlywiki.infofiles - Fixed problem with invisible icons in $:/AdvancedSearch
- Improved check for required plugins in ServerCommand
- Fixed problem with queueing change events for deleting non-existent tiddlers
- Ensure EditTextWidget fixes height even if refresh isn't required
- Fixed the gradient on the sidebar tabs divider
- Fixed problem with tiddler titles such as
$:/templates/somethingbeing erroneously classed as$:/temptiddlers, and so excluded from syncing - Switched to absolute date format in tiddler subtitles
Node.js Improvements
- Fixed problem with the filesystem adaptor saving new image files as base64-encoded .tid files instead of as native binary files with an accompanying
.metafile - Extended
tiddlywiki.filessupport in TiddlyWikiFolders to allow directories to be loaded recursively, as well as individual files
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a bug-fix release for Release 5.1.10 that fixes a serious issue affecting the operation of the official plugin library.
See GitHub for detailed change history of this release
Major Improvements
New Editor Toolbars
Added support for extensible formatting toolbars for the editor widgets.
- Formatting operations for WikiText, with support for Markdown:
- Character formatting operations for bold, italic, strikethrough, underline, superscript, subscript, inline monospace
- Line formatting operations for monospaced blocks, quoting, headings and both numbered and bulleted lists
- Insert picture from a dropdown chooser
- Stamp snippet of pre-programmed text
- Excise selected text into a new tiddler
- Optional automatic resizing to fit content
- Full keyboard shortcut editor in control panel. Shortcuts are also shown in the toolbar button tooltips
Improved Bitmap Editor
The bitmap editor has been enhanced with a toolbar supporting:
- Painting with selectable colour, width and opacity
- Clearing the image
- Resizing the image
- Keeping track of recently chosen colours
Improved Plugins
Several of the official plugins available in the plugin library have been updated for this release. Upgrading will automatically update any installed plugins.
- The KaTeX plugin has been updated to version v0.60.0
- The CodeMirror plugin has been updated to version 5.13.2, and integrated with the new editor toolbars. The default configuration has been updated to include syntax highlighting for HTML, JavaScript, CSS, XML, TiddlyWiki Classic and Markdown.
- The Markdown plugin includes formatting toolbar buttons and a new "new markdown tiddler" button in the Tools tab of the sidebar.
- The experimental Evernote plugin allows notes and images from
.enexfiles to be imported into TiddlyWiki. - The new Internals plugin provides features to help understand the internal operation of TiddlyWiki, including new preview modes in the editor showing both the parse and widget trees of the current tiddler
- Improved language translations:
- Korean
- Chinese (Simplified) and Chinese (Traditional)
- German
- French
- Danish
- Dutch
Text-Slicer Plugin Improvements
- Added support for sticky notes within documents
- Extended support for slicing documents to Node.js
- Improved document metadata display
- Added
list-childrenfilter operator - Fixed bugs
Other Improvements
Usability Improvements
- Added a setting for disabling linking to missing tiddlers
- Added a setting for forcing word wrapping in monospaced code blocks
- Added a warning when creating or editing tiddler titles containing troublesome characters
- Addition of “new image” button to the “Tools” tab of the sidebar
- Introduction of new general purpose colour-picker Macro
- Introduction of new general purpose image-picker Macro
- Added a bulk delete button to advanced search "Filter" tab
Hackability Improvements
- Introduction of the new WikifyWidget
- Introduction of new EditShortcutWidget for direct entry of keyboard shortcut codes
- Extended editor preview pane to allow plugins to add further types of preview (see the new
tiddlywiki/internalsplugin for an example) - Added a simple HTTP PUT saver for use with WebDav or REST servers
- Added build targets to the server edition
- Improved days Operator to better cope with operations on today and yesterday
- Extended ActionWidgets mechanism to allow them to be used with the LinkCatcherWidget and SelectWidget
- Added
mobile-web-app-capablemeta tag for Android Chrome - Added new
plainwikifiedformat for the ViewWidget
Bug Fixes
- Fixed problem with tiddler titles containing single quotes in Table-of-Contents Macros
- Fixed problem with z-ordering of modals in zoomin story view
- Fixed problem with has Operator
- Fixed problem with double byte entities in the EntityWidget
- Fixed problem with ScrollableWidget in static renderings
- Fixed problem with repeatedly lazy loading of tiddlers without a text field
- Fixed problem with titles containing URLs being interpreted as external links
Node.js Improvements
- Added ability to customise the paths used for tiddler saving
- Fixed problem saving non-JPG binary files
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a minor bug fix release.
Bug Fixes
- Fixed (and refixed) problematic stricter external link matching rules introduced in 5.1.12
- Fixed problem with tiddlers titled "undefined"
- Fixed rendering problem with KaTeX Plugin
- Removed unneeded border in print stylesheet
Node.js Bug Fixes
- Fixed problem with extraneous
.tidextension added to tiddler filenames
Other Improvements
- Updated Portuguese (Portugal) translation
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
New and Improved Plugins
- Added SaveTrail Plugin that continuously downloads edited tiddlers in the background, providing a trail of backups
- Added XLSX Utilities plugin for importing Excel-compatible spreadsheets. See the XLSX Utilities Edition for details
- Added QR code generator plugin
- Added BibTeX importer plugin
- Updated Google Analytics plugin to the latest version
- Added Twitter Plugin for embedding tweets etc
- Updated KaTeX Plugin to v0.7.1 of KaTeX
Improved Support for Drag and Drop
There are several improvements to Drag and Drop:
- Ability to rearrange the "Open" sidebar panel and the tag dropdown (and new tiddlers can be opened by dragging them to the list)
- Ability to reorder entries in tag dropdowns
- Dragging a tag pill is now equivalent to dragging all of the tagged tiddlers together
- Entries in the control panel "Appearance"/"Toolbars" tab can be reordered by drag and drop
- The image shown while dragging now reflects the dragged item, instead of being a generic drag pill
New "Heavier" Theme
A new theme called "Heavier" thickens TiddlyWiki's default lightweight fonts. A variant "Tight-Heavier" combines the "Heavier" theme with the existing "Tight" theme:
New Tiddler Manager
Added new tiddler manager to support tasks such as:
- Reviewing and applying tags to a large number of tiddlers
- Tweaking the custom colours and icons for a large number of tiddlers
The tiddler manager will be extended in the future to increase flexibility and to add support for bulk operations.
Performance Improvements
- Extended search mechanism to require the search string to be a minimum length
Translation Improvements
- Improvements to Danish, Dutch, French, German, Portuguese and Chinese translations
- Added new Hebrew translation
- Added preliminary support for right-to-left (RTL) languages
Usability Improvements
- Added a select all/none checkbox to the header of the import panel
- Added "close plugin library" button
- Added support for adding tags using the enter key
- Improved handling of ctrl-Enter to add partially completed tags and fields
- Added support for relinking references to renamed tiddlers
- Added new "print page" page control button (and added associated icon)
- Added new page control button to temporarily suspend timestamps
- Improved access to plugin information:
- Refactored the display of plugin tiddlers to use the same format as the control panel, adding the shadow tiddler listing as an overridable extension tab
- Added a new tab in the “More” sidebar providing quick access to all installed plugins
- Fixed height of preview pane to use a scrollbar when fixed height layout is selected
- Extended editor "link" button to create external links and missing links
- Increased size of icons in the "Filter" tab of $:/AdvancedSearch
- Fixed problem with multiple copies of a tiddler appearing in the story river
- Improved dropdown for new field names with typeahead search
- Improved the ordering of groups in the tiddler editor content type dropdown
- Added "sticky" mode for tiddler info panel. See "Settings" in control panel
- Increased boldness of tag pill text
- Added documentation marker to indicate the version in which a new feature was released
- Added an entry to the advanced search filter drop down for exporting the current story (minus advanced search)
New and Improved Filter Operators
- Added new enlist Operator
- Added several new filter operators for string encoding/decoding:
- Added new minlength Operator
- Added new order Operator
- Added strict mode to tag Operator
- Added new tags option to the all Operator
- Changed is Operator to pass through arguments if the operand is blank
- Added "field" suffix for has Operator
- Improved wikiparserrules Operator to return all available parse rules
Hackability Improvements
- Added support for "formattedtext" output type to the WikifyWidget
- Added a saver for the peer-to-peer Beaker browser; see TiddlyWiki on Beaker Browser for details
- Refactored the tag templates and macros to make them more reusable
- Improved modals and notifications so that global macros are available
- Extended the SetWidget to allow a single result to be selected from a filtered result list
- Added new
$:/info/url/*information tiddlers providing document location information - Added support for the actions attribute to the CheckboxWidget
- Extended CheckboxWidget to support data tiddlers via the
indexattribute - Added new entry to the advanced search filtered export menu for exporting the current story river
- Added
tagattribute to the KeyboardWidget - Added overwrite protection to the WebDAV saver
- Added new "big block quote" style for Block Quotes in WikiText
- Added customisable template text for new journal tiddlers, accessible the control panel
- Added support for
.jsontiddler files containing a single tiddler object, instead of an array of tiddlers
Node.js Improvements
- Fixed multiple issues the creation of new tiddler files by the filesystem adaptor
- Added new FetchCommand for retrieving tiddlers over http/https
- Enhanced RenderTiddlerCommand to add support for an additional variable
Bug Fixes
- Improved Node.js support for the HighlightPlugin
- Fixed problem with recursion errors in the Table-of-Contents Macros
- Prevented email addresses from being mis-recognised as HTML tags
- Fixed issue with
$tw.utils.strEndsWith() - Partially fixed problem with action widgets being invoked independently of refresh cycle
- Revised handling of
syncAdaptor.isReady()method to improve compatibility with older adaptors - Fixed problem with unsafe use of
String.prototype.replace(), corrupting fields containing dollar signs - Fixed problem with page background colour not showing through transparent background images
- Fixed sync problem with skinny tiddlers not being loaded
- Fixed problem with "Cancel" button in login dialogue also submitting the form
- Fixed typo affecting created/creator fields when deleting a field
- Fixed issue with system links containing international characters not being recognised
- Fixed issue with single line macro definitions without a terminating line break
- Fixed issue with empty strings and the CheckboxWidget
- Fixed problem with calculation of week numbers
- Fixed problem with move Operator not wrapping correctly
- Fixed problem preventing customisation of textarea background colours
Developer Bug Fixes and Improvements
- Updated Stanford JavaScript Library to version v1.0.6
- Updated Google Analytics plugin to latest version of Google's code
- Improved Common/JS compatibility by adding support for implicitly adding
/index.jsto a require target - Improved support for bulk loading tiddler files via tiddlywiki.files Files within TiddlyWikiFolders
- Refactored server mechanism to make it simpler to integrate TiddlyWiki into ExpressJS apps
- Refactored the TiddlyFox saver module to make it easier to use it with other saving mechanisms
- Added (and here) several new UI hooks, and improved the hook mechanism; see developer docs
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
New and Improved Plugins
- New Amazon Web Services Plugin with primitives for running TiddlyWiki in the cloud
- New External Attachments Plugin that allows automatic creation of ExternalImages for TiddlyDesktop
Translation Improvements
New and improved translations:
- New Persian translation
- Updated Chinese and Greek translations
Another improvement that benefits users of translations is the addition of about 800 new transliteration pairs. These are substitutions that are performed when converting a tiddler title into a filename, such as the two characters "oe" for the single character "œ". See the commit for more details. The result is that automatically generated filenames are much more readable.
Usability Improvements
- Added new "Explorer" tab to "More" sidebar and underlying tree Macro
- Added configuration option in theme tweaks for the editor font
Hackability Improvements
- Added new lookup Operator to simplify use of lookup tables
- Extended the SetWidget with tiddler, field and index attributes
- Added new whitespace Pragma allowing whitespace to be selectively ignored within wikitext
- Updated support for saving in Beaker Browser
- Extended date formatting to support milliseconds and UTC dates
- Extended LinkCatcherWidget to make the target tiddler available within the action string
- Extended (and here) the DropzoneWidget and BrowseWidget to allow the deserializer to be manually specified
- Added new
tc-btn-*classes to toolbar buttons allowing easier custom styling - Added new mode attribute to the ViewWidget, allowing control over the parsing mode for wikified output formats
- Added new jsonstringify Operator
Node.js Improvements
- Added SaveCommand and RenderCommand, intended as more flexible replacements for RenderTiddlerCommand, RenderTiddlersCommand, SaveTiddlerCommand and SaveTiddlersCommand
- Added (and here) more colour to command line output
- Added new "raw" options to the FetchCommand
- Added new ImportCommand
Bug Fixes
- Fixed problem with "new journal" button clearing the text field
- Removed extraneous URI encoding of filename with PUT saver
- Restored ability to use sub-filter with image-picker macro
- Fixed problem with the download saver and filenames containing spaces, accents or other characters that need URL encoding
- Fixed problem with importing JSON tiddlers with leading or trailing spaces in the title
- Fixed plugin display so that "contents" tab is shown even if no other tabs are provided
- Fixed problem with
allbefore:includefilter operator - Updated Update Stanford JavaScript Library to version 1.0.7
Developer Bug Fixes and Improvements
- Extended
$tw.boot.boot()to add a callback parameter - Extended navigation handling to pass original event data
- Added new
th-importing-fileshook
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Improved CodeMirror Plugins
The CodeMirror plugin has undergone a substantial rewrite, with many new improvements:
- Upgrade to CodeMirror version v5.37.0
- Now modularised into:
- Base plugin: basic lightweight configuration, approximately 240KB
- Add-on plugins:
- Search and Replace
- Auto-completion
- Fullscreen editing
- Auto-close brackets
- Auto-close tags
- SublimeText keymap
- Emacs keymap
- Vim keymap
- Highlighting modes: Javascript, Xml, Html (htmlmixed), Html (htmlembedded), Css, Markdown, X-Tiddlywiki
- Automatic configuration (the configuration tiddler is not needed anymore)
- CodeMirror (engine.js) builds the configuration using information within the installed CodeMirror plugins
- New control panel configuration tab:
- Line numbers
- Theme:
- Editor font family (same as native TiddlyWiki)
- Cursor settings
- Line wrapping
- Active line highlighting
- Autocompletion on/off (if installed)
- Keymap
Other New and Improved Plugins
- New Dynaview Plugin makes it possible to build user interfaces that dynamically respond to changes in scrolling or zooming
- Improved Text-Slicer Plugin with customisable JSON rules
- Updated KaTeX Plugin to latest v0.9.0
Translation Improvements
New and improved translations:
- New Slovenian translation
- New Português (Brasil) translation
- Improved Dutch translation
- Improved French translation
- Improved German translation
- Improved Traditional and Simplified Chinese translations
- These translations now also reset the minimum search length to one character
Privacy Improvements
Prompted by the General Data Protection Regulation (GDPR), we've removed all third party cookies from tiddlywiki.com.
Usability Improvements
- Added new DiffTextWidget, and integrated it into the import listing and as a preview pane
- Added selectable previews to the import listing
- Added new editor toolbar buttons for wrapping the selection with double square and curly brackets
- Added new sortan Operator for sorting alphanumeric values such as "Apple 6", "Apple 7", "Apple 8", "Apple 9", "Apple 10", "Apple 20", "Apple 30", "Apple 100"
- Improved default fonts for readability as advised by GitHub
- Added an editor toolbar button for stamping fragments of formulae for the KaTeX Plugin
- Simplified the page scrolling behaviour: navigating to a tiddler now scrolls the top of the tiddler to the top of the viewport
- Added WidgetMessage: tm-copy-to-clipboard and also copy-to-clipboard Macro for copying text directly to the clipboard
- Added a hint to the field list dropdown
- Added a control panel setting for the default tab in the More sidebar
- Added a control panel setting for the titles of new tiddlers
- Added "rotate left" button to bitmap editor toolbar
- Improved criteria under which certain editor toolbar buttons are displayed
- Added support for a minimum length for the new tag field before the dropdown is shown
- Improved consistency and reusability of the palette, language and theme switchers
- Added support for retaining tab content in the tabs Macro
- Added support for adding links via the enter key
Hackability Improvements
- Added support for comparison operators to the RevealWidget
- Added support for StartupActions to execute action widgets at startup
- Extended ServerCommand to allow the port number to be specified as an environment variable
- Added screen width/height to platform information exposed at startup
- Extended DroppableWidget to pass modifier keys in a variable
- Extended DraggableWidget with actions for drag start and drag end
- Added a new TaskManagementExample (Draggable)
- Added new 'Stylesheets' tab to control panel
- Added new 'emptyMessage' parameter to list-links Macro and list-tagged-draggable Macro
- Added new
th-page-refreshedhook - Enhanced macro evaluation by making parameters available as variables - see "Parameters as Variables" in Macro Definitions in WikiText
- Enhanced LinkWidget to allow better customisation of CSS classes
- Added new "value" suffix for the each Operator
- Added new subtiddler attribute to the SetWidget
- Added new subtiddlerfields Operator for extracting the fields from tiddlers within plugins
- Added ability to trigger actions on unchecking the CheckboxWidget
- Added support for a checked class to the RadioWidget
- Extended the is Operator to allow multiple types to be specified
- Added data attributes to ViewTemplate (see Custom data-styles)
- Added new RangeWidget
Bug Fixes
- Removed superfluous list item at the end of list-links-draggable macro
- Fixed problem with the content area of vertical tabs sometimes overflowing their right hand margin
- Fixed problem with double quotes within the new journal template
- Fixed problem with dragging inside a textarea
- Fixed usage of "default" attribute of SelectWidget when "index" attribute is used
- Fixed problem with crash when dragging over TiddlyWiki on some browsers
- Fixed issue with new journal button
- Fixed problem with filter and value attributes of SetWidget
- Fixed problem with numeric operands in the The Extended Listops Filters
- Fixed problem with "put" saver and 412 return codes
- Fixed problem with variable references in field values in the edit template
- Extended behaviour of list-after field so that the tiddler is placed at the end of the list if the list-after field is present but empty
Developer Bug Fixes and Improvements
- Added plugin-priority field to core plugins
- Fixed problems with plugin ordering
- Several optimisations to the tiddler store:
- Avoiding slow Object.keys calls - saving 50% of some operations
- Optimising the tag filter - saving 50% on some tag operations
- Minor improvements to tiddler deletion
- Added support for custom boot paths
- Added new navigation hooks:
th-cancelling-tiddler,th-new-tiddlerandth-renaming-tiddler - Added new hook when the HTTP server starts
th-server-command-post-start
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Reversions
After encountering significant problems we've reluctantly decided to remove support for multiple sub-operators with the is Operator that was added in v5.1.16.
Usability Improvements
- Improved appearance of TiddlyWiki's "red screen of embarrassment"
Bug Fixes
- Fixed problem with extraneous space in new journal titles
- Fixed problem with repeated use of "new journal" with text set
- Fixed (and here) problem with Etag handling
- Fixed problem with is Operator introduced in 5.1.16
- Restored default of the preview pane being hidden
- Fixed incorrect plugin library location
- Fixed animation timing problem with reveal widget that sometimes caused the sidebar not to show when requested
- Fixed problem with saving with non-Dat URI schemes
- Fixed deletion of
$:/status/UserNamewhen logged out
Node.js Improvements
- Stopped clearing $:/status/UserName when logged out
- Fixed bug with attempting to lazy load tiddlers that do not qualify for syncing
- Added support for
/*\style metadata comments at the top of*.CSSfiles
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Major Improvements
Global Keyboard Shortcuts
This version introduces new infrastructure to handle global keyboard shortcuts. The core ships with the following shortcuts:
- alt-I (or ctrl-I on Mac) - New image
- alt-J (or ctrl-J on Mac) - New journal
- alt-N (or ctrl-N on Mac) - New tiddler
See How to create keyboard shortcuts
Node.js HTTP Server
The HTTP WebServer functionality has been significantly improved:
- Adds ability to make a wiki that is read-only for anonymous users (with the editing UI hidden), but allows editing for users who log in
- Hides UI features like the new tiddler button and the edit button when the user only has read-only access to the wiki
- Adds support for serving static file attachments over HTTP
- Adds support for multiple user credentials for basic authentication via a CSV file containing usernames/passwords
- Adds support for serving over HTTPS as well as HTTP
- Adds support for authentication via a trusted header, making it easier to integrate with corporate single sign on (and Windows authentication)
- Adds support for more fine grained authorisation (ie granting/denying individual users read/write permission to resources)
- Better debugging information
- Experimental support for a new, plain HTML single tiddler per page view
- Adds a simple level of CSRF protection
- Deprecating the existing ServerCommand in favour of a new ListenCommand using the new NamedCommandParameters support for named parameters that can be specified in any order
- Refactoring routes as separate modules, making it easier to extend the server with new functionality
See WebServer for more details, or see the changes on GitHub.
Special Characters in Tiddler Titles
In previous versions of TiddlyWiki, there were some special character sequences in tiddler titles that would break certain features. For example, a tiddler title ending in double quotes would cause the Table-of-Contents Macros to render incorrectly.
As of 5.1.18, many of these problems have been fixed by refactoring the features to use the latest abilities of wikitext:
Note that using certain characters in tiddler titles will still prevent some features from being used correctly. For example, two vertical bar characters are used in the double curly braces transclusion syntax to separate the tiddler title from the template title: {{title||template}}. However, although it would be impossible to transclude a tiddler called title||template using that syntax, one could still transclude it using <$transclude tiddler="title||template"/>.
Plugin Improvements
- KaTeX Plugin – the KaTeX Plugin has been updated to KaTeX v0.10.0. The plugin now incorporates an extension for chemical formulae
- Comment Plugin – this release adds a new commenting plugin – see $:/plugins/tiddlywiki/comments
- AWS Plugin – support for running TiddlyWiki as a Lambda function has been improved with support for GZip compression of the JSON payload
Translation Improvements
New and improved translations:
- Catalan
- Chinese Simplified and Chinese Traditional
- Dutch
- French
- German
Usability Improvements
- Added support for splash screens to be shown while TiddlyWiki is loading – see Creating a splash screen
- Added display of backlinks when renaming a tiddler
- Added persistent indicators at the bottom of the window showing any hidden drafts
- Added current username (if set) to the title of draft tiddlers, making them easier to identify in multiuser scenarios
- Added a warning for binary tiddlers in view mode
- Extended permalink/permaview to copy the URL to the clipboard as well as updating the address bar. This behaviour can be customised in $:/ControlPanel settings
- Improved saving to use the $:/SiteTitle as the basis of the filename
- Added support for webp, heic and heif image formats
- Fixed tiddler positioning when creating new tiddlers
- Fixed smooth scrolling in new windows
- Fixed problem dismissing popups within new windows
- Fixed handling of disabled missing links so that core user interface features are not broken (see also here)
Hackability Improvements
- Added a new filter prefix
~allowing if-then-else logic within filters – see Filter Expression - Added a new subfilter Operator to allow nested filters to be used
- Added new stateTitle, stateField and stateIndex attributes to the ButtonWidget and the RevealWidget, making it possible to use state tiddlers whose titles contain
!!or## - Enhanced the search Operator to support searching arbitrary lists of fields, literal searches, whitespace-tolerant searches and regexp searches
- Added new contains Operator for searching within list fields
- Added support for a navigation scroll offset to avoid navigating to tiddlers resulting in them being obscured under a
position:fixedtop menu bar – see Hidden Setting: Scroll Top Adjustment - Extended WidgetMessage: tm-full-screen message to support forcing the status instead of just toggling it
- Refactored the sidebar to make it be dynamically built from the tag
- Refactored the tiddler info panel to make it be dynamically built from the tag
- Added new range Operator for generating ranges of numbers
- Added palette support for
<select>element colouring - Added new text editor operation save-selection – see WidgetMessage: tm-edit-text-operation
- Added support for editor toolbar buttons to have action widgets
- Added support for rebasing headings at render time – see tv-adjust-heading-level Variable
- Added experimental support for packaging TiddlyWiki's JavaScript core into an external script for use with the new Web Server enhancements
- Added new
\importPragma as a more concise alternative to using the ImportVariablesWidget directly - Added (and here) new tv-show-missing-links Variable for tighter control over rendering of missing links by the LinkWidget
Bug Fixes
- Fixed with WidgetMessage: tm-new-tiddler overwriting creation fields of existing tiddlers
- Fixed problem with unwanted variable substitutions by restricting variable substitutions to macros defined with the define pragma
- Fixed problem with the 'excise' editor toolbar button not showing if the tiddler type is "text/vnd.tiddlywiki"
- Fixed problem with generation of wifi QR codes
- Fixed $tw.platform.isLinux on the latest Firefox
- Fixed problem with using full screen on secondary windows
- Fixed subtle bug whereby the RevealWidget was not refreshing properly when the state tiddler of a popup changed
- Fixed problem with malformed HTML entities
- Fixed crash when passing illegal arguments to the decodeuri Operator and decodeuricomponent Operator
- Fixed errors when a popup blocker blocks opening a new window
- Fixed problems using a lazily loaded tidler as a state tiddler with the RevealWidget
- Fixed problem with modals not appearing in the correct window
- Fixed the animations for adding and removing tags in edit mode, and a similar fix for the animations in the "Open" sidebar tab
Developer Bug Fixes and Improvements
- Refactored
$tw.utils.parseStringArray()to optionally allow non-unique entries
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This release consists of fixes for bugs discovered in Release 5.1.18.
Hackability Improvements
Bug Fixes
- Fixed incompatible change to the construction of filename used for saving
- Fixed problem with fonts for the KaTeX Plugin
- Fixed problem with forcing basic authentication for the WebServer
- Fixed problem with the ButtonWidget not refreshing when the
popupTitleattribute changes - Fixed problem with
empty.htmlaccidentally containing a splash screen - Fixed regression with search matches across multiple fields
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is another small release with documentation updates and a few bug fixes and improvements.
Usability Improvements
- Improved error handling for malformed or unrecognised LaTeX content with KaTeX Plugin
Hackability Improvements
- Improved styling of separator before the untagged item in the tags sidebar
- Improved error handling for the upload saver (which is used for saving to TiddlySpot)
- Improved storyview error detection
Bug Fixes
- Fixed crash caused by incorrectly formatted plugins
- Fixed problem with tiddler info not being removed by the syncer after deleting a tiddler
- Fixed HTTP handling to treat response code 201 as success
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
New Conditional Operators
Added new Conditional Operators then Operator and else Operator
New Mathematics Operators
Added several new Mathematics Operators for working with numbers: negate, abs, ceil, floor, round, trunc, untrunc, sign, add, subtract, multiply, divide, remainder, max, min, fixed, precision, exponential, sum, product, maxall and minall.
New String Operators
Added several new string operators: match, length, uppercase, lowercase, titlecase, sentencecase, trim, split, splitregexp and join.
Improved Handling of Duplicates in Filters
There is now finer control over TiddlyWiki's default behaviour of removing duplicates from filter results, making it much easier to work with the new mathematics and string operators:
- Added support for new
=prefix for merging filter runs without removing duplicates - Added option for the enlist Operator to not remove duplicates
Improved Keyboard Shortcuts
Keyboard shortcut handling has been significantly improved with the following new global shortcuts (configurable via $:/ControlPanel):
- ctrl-shift-F - focus the sidebar search field
- alt-shift-S - toggle the visibility of the sidebar
- ctrl-shift-A - open the advanced search tiddler
Saving to GitHub and GitLab
Added a Git service saver for saving directly to GitHub and GitLab
Plugin Improvements
New and improved plugins:
- New BrowserStorage Plugin for saving tiddlers in browser local storage
- New Innerwiki Plugin for rendering TiddlyWiki screenshots
- Updated KaTeX Plugin to KaTeX v0.10.2
- Added an editor toolbar button for the KaTeX Plugin
- Updated Highlight Plugin to use highlight.js v9.15.6
- Added support for language aliases with the Highlight Plugin
- Updates to the CodeMirror Plugin, including adding support for smart indent
- Updates to the Dynaview Plugin, including adding support for restoring the scroll position at startup from local storage
- Updates to the Amazon Web Services Plugin, including adding support for specifying credentials
Translation Improvements
New and improved translations:
- Catalan
- Chinese Simplified and Chinese Traditional
- French
- German
- US English
Performance Improvements
- Added pluggable index modules to accelerate the field Operator and the tag Operator (in tests on a wiki with 60K tiddlers, startup time is reduced by 25% with these optimisations, and refresh time is reduced by a factor of three.)
- Optimised the "Classic" storyview to perform much faster when the animation duration is set to zero (approximtely 50% speed improvement was observed in tests opening a storyview with 8,000 entries)
- Optimised the RevealWidget to avoid using the relatively slow
localeCompare()method to compare strings - Updated Performance Instrumentation to show the timings for individual filters
- Optimised rendering and refreshing child widgets
Usability Improvements
- Improved the palette manager with the ability to delete entries, and directly edit indirect entries
- Several new palettes: "Nord", "Solarized Light", "Spartan Day", "Spartan Night" and "Twilight"
- Fixed the plugin library to search all plugin fields
- Added a warning when core JavaScript modules are overwritten via import
- Fixed prompt for references when renaming a tiddler
- Added a new filter preset for advanced search for "tiddlers modified this session"
- Added a number of animations (some of were already present but had been broken over the years) for changes in:
Hackability Improvements
- Added support for configurable view and edit templates
- Improved the dumpvariables Macro
- Added new variables Operator and getvariable Operator
- Added new WidgetMessage: tm-focus-selector
- Added new escapecss Operator
- Added new unusedtitle Macro
- Added new
[is[variable]]option to the is Operator - Added new
[is[blank]]option to the is Operator - Added optional autofocus for the text inputs in $:/AdvancedSearch (controlled by the same Hidden Setting: Search AutoFocus as the sidebar search)
- Added optional tabindex attribute to simple, framed and CodeMirror text editor engines
- Added tabindex attributes to edit templates
- Added outline colour to button, textarea, input
- Added tooltip attribute to SelectWidget
- Added an option for plugins to disable the initial navigation at startup
- Added $:/info/browser/language to the InfoMechanism
- Added an example of using StartupActions to set the default language
- Improved importing of JSON files to verify whether they are valid tiddler files, and import them as plain JSON if not
- Improved the LinkWidget to use the title of the target tiddler as a default if it has no content
- Improved WidgetMessage: tm-open-window to allow a window title to be specified
- Added checkActions attribute to the CheckboxWidget
- Added support for searches anchored to the start of a field
Bug Fixes
- Fixed a long standing problem with the main standalone HTML file template whereby raw markup tiddlers would be included even if not selected by the save filter
- Fixed overlapping dropdowns with sticky titles enabled
- Removed apparently obsolete limitation of selection wrapping in text editor
- Fixed bug in RevealWidget when stateTitle tiddler is missing
- Fixed bug with animation duration being blank
- Fixed Firefox problem with drag and drop placeholders in the "open" tab of the sidebar
- Ameliorated Firefox problem with sticky placeholder during drag and drop operations
- Fixed CodeMirror Plugin to use tiddler-editor-border colour
- Fixed problem using the TiddlySpot saver with cookies disabled
- Fixed framed text editor to use correct background colour
- Fixed problem with the class
tc-sidebar-listsbeing used on two different areas of the sidebar, making it impossible to distinguish them in CSS selectors - Fixed problem with unnecessary "list" field created when renaming tiddlers
- Fixed crash with EditBitmapWidget and missing tiddlers
Node.js Bug Fixes and Improvements
- Added new SaveWikiFolderCommand to save a wiki as a wiki folder
- Added new DeleteTiddlersCommand
- Added (and also here) ability to specify plugins on the command line (see Using TiddlyWiki on Node.js)
- Added support for deflate and gzip compression to the WebServer ListenCommand
- Added an option to the LoadCommand to ignore loading errors
- Improved handling of JSON files by the file system adaptor:
- Use
.jsonfiles (instead of.tid) for any tiddler whose fields contain values that can't be stored as a .tid file - Save
application/jsontiddlers as.jsonfiles
- Use
Developer Bug Fixes and Improvements
- Added support for widget subclassing – see https://tiddlywiki.com/prerelease/dev/#WidgetSubclassingMechanism
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a bug fix release that resolves issues introduced in the recent Release 5.1.20.
Bug Fixes
- Fixed crash with ActionDeleteFieldWidget and a missing tiddler attribute
- Fixed edge cases where some tiddler lists were not valid when interpreted as a filter
- Fixed problem with too many alerts when upgrading a wiki containing an overwritten core module
- Reverted inadvertently switching on performance instrumentation
- Fixed bug with WikiText within field names
- Fixed problem with classes in the Table-of-Contents Macros
- Fixed missing foreground colour for buttons with class
tc-btn-invisible - Fixed whitespace around field editor inputs
- Fixed layout problems with the translators edition
- Fixed crash with the External Attachments Plugin on Windows
- Removed inconsistent shadow for tag pills in the sidebar
- Fixed regression with the field Operator and blank operands
- Reverted erroneous change in v5.1.20 in the way that lists are stringified
- Fixed the Open sidebar tab to use the
tv-story-listvariable - Fixed problem saving to GitLab
Node.js Bug Fixes
- Fixed bug with customised tiddler file naming
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Usability Improvements
- Added "new journal" button; see Creating journal tiddlers
- Added "new here" button; see Creating and editing tiddlers
- Added "new journal here" button; see Creating journal tiddlers
- Made date format strings be translateable
- Added Russian translation
- Added confirmation when clearing password
- Added additional prompt when setting password
- Increased size of the clear search button
- Upgraded to KaTeX v0.1.1, with support for several additional LaTeX features
Hackability Improvements
- Added audio "parser" for handling Audio content
- Added support for ActionWidgets
- Added new
addprefixandaddsuffixoperators - Added support for custom password prompts
- Extended the
list-linksmacro to display caption field if present - Extended ImageWidget to allow percentage width and height to be specified
Bug Fixes
- Fixed the
eachoperator to work with missing tiddlers - Fixed problem with tiddler width in zoomin storyview with the sidebar hidden
- Fixed bug whereby the
tm-homemessage wasn't navigating to a tiddler, causing problems in zoomin storyview - Fixed problem with jumping toolbar icons under Firefox
- Fixed problem with untagged label being incorrectly coloured
- Fixed problem with title background colours with the "Sticky Titles" theme
- Fixed problem with subfilter parameter of
timelinemacro - Exclude search string tiddler from search results
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Extended KaTeX plugin to be able to work under Node.js to generate static HTML
- Extended "includeWikis" to merge build targets
- Refactored the build scripts for tiddlywiki.com into a separate repository at https://github.com/Jermolene/build.jermolene.github.io
- Extended boot kernel to raise an error if a missing wiki folder is specified on the command line
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a small release with documentation improvements and some important bug fixes from Release 5.1.3.
Usability Improvements
- Added a toolbar button for advanced search
- Changed dragging behaviour so that you can drag a tiddler title into an edit box to insert the title, making link creation easier. (This change doesn't affect the behaviour of dragging tiddler links between TiddlyWiki windows)
Hackability Improvements
- Added additional theme tweaks for the body text size and line height
- Extended the ViewWidget to work with subtiddlers
Bug Fixes
- Fixed problem with search counts
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Fixed problem with missing wiki folder warnings by removing and re-implementing the fix from Release 5.1.3
- Added coloured warnings and errors under Node.js
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Translation Improvements
- Added new translators edition making it much easier to create and maintain translations of TiddlyWiki
- Added improved Japanese translation
- Added new Danish translation
- Added new Greek translation
Usability Improvements
- Improvements to tooltips for accessibility
- Added export button to tiddler toolbar, page controls and advanced search "filter" tab
- Improved layout of $:/TagManager
- Simplified default tiddler toolbar buttons
- Added advanced search button to sidebar search results
- Improved search results by listing title matches at the top
- Added input box for specifying new field value in edit template
- Improved tag pill rendering so that the foreground colour is dynamically chosen for maximum contrast with the background colour
- Enhancements to many of the core icons
- Removed (and here, here and here) unnecessary confirmations when abandoning or deleting unmodified tiddlers
- Added a subtle rounded corner to tiddlers and tabs
- Added automatic focusing of the title of newly created tiddlers
- Added advanced search links on tiddler counts in $:/ControlPanel
Hackability Improvements
- Introduced new ActionSetFieldWidget, ActionDeleteFieldWidget and ActionDeleteTiddlerWidget for manipulating tiddler fields and values
- Enhanced WidgetMessage: tm-new-tiddler to allow a skeleton to be specified with additional fields
- Enhanced the EditTextWidget to allow more control over the sizing of textarea editors
- Added new canned filter for recently modified system tiddlers in $:/AdvancedSearch
- Added new system image for videos: $:/core/images/video
- Extended search results to allow custom visualisations - see Customising search results
- Extended
timelinemacro to be able to use different date fields - Updated the
searchoperator to allow a field to be specified - Updated the highlight plugin to display tabs as spaces
- Extended modal handling to permit variables to be passed to the modal (see WidgetMessage: tm-modal)
- Added simple logging to help track down drop/paste issues (see https://tiddlywiki.com/dev/#ImportLogging)
- Updated WidgetMessage: tm-download-file and WidgetMessage: tm-save-wiki to allow variables to be specified for the rendering
- Added Example Table of Contents: Tabbed Internal
- Extended RevealWidget so that it can be used without specifying a state tiddler
- Added "hooks" mechanism so that plugins can modify the default tiddler list
- Added support for nested popups
Bug Fixes
- Fixed problem with CodeMirror editor and missing tiddlers
- Exclude drafts from Table-of-Contents Macros
- Fixed problem with encoding of HTML tiddlers
- Fixed problem with sticky titles being covered by vertical tabs
- Removed flicker when automatically resizing textareas
- Fixed JSON deserialiser so that all fields can be imported
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Extended includeWikis mechanism of TiddlyWikiFolders to allow read-only wikis to be included
- Improved error handling under Node.js
- Added UnpackPluginCommand
- Added EditionsCommand to list the available editions
Changes affecting plugin authors
- Disabled wiki change events for shadow tiddlers
- Updated structure of widget messages that have a hashmap parameter
- The support for nested popups has necessitated a change in the way that popups are styled that affects popups that are triggered with the focusPopup attribute of the EditTextWidget: it is now necessary for the widget to be given the class
tc-popup-handle.
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Translation Improvements
- Added Dutch translation
- Updated Danish and Japanese translations
Hackability Improvements
- Allow buttons to be styled to look like internal links
- Disabled linking when transcluding caption field in Table-of-Contents Macros
- Added support for templates to tabbed Table-of-Contents Macros
- Allow shadow tiddlers to appear in Table-of-Contents Macros
- Added tooltip to BrowseWidget
- Improved handling of missing tiddlers by the
hasandfieldoperators
Bug Fixes
- Fixed problem with download saver using incorrect filename
- Fixed problem with processing of date format templates
- Fixed problem with storytop theme tweak not being respected when the narrow responsive design kicks in
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Fixed problem with "all tiddlers" static HTML export
- Fixed incorrect checking for an empty folder with the InitCommand
Changes affecting plugin authors
- Extended
$tw.utils.eachso that the loop can be broken out of
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is an hot fix release with the following change over Release 5.1.6:
- Fixed typo in GettingStarted
See GitHub for detailed change history of this release
This release includes many improvements to the documentation for TiddlyWiki. Many thanks to everyone who has helped out, but especially to our prodigious new contributor Astrid Elocson.
Translation Improvements
- Improvements to French, Danish, Chinese and Japanese translations
- Added Czech translation
- Added Interlingua translation
- Added Portuguese translation
- Added Punjabi and Hindu translations
- Added Slovak translation
- Added Spanish translation
- Added localisation for encryption prompt
Usability Improvements
- Added user interface for setting a page background image
- Fixed problem with unnecessary scrolling at startup
- Upgraded the KaTeX Plugin to use KaTeX v0.2.0, with better symbol support
- Added Help Plugin providing floating help panel
- Added support for an online plugin library
- Added automatic focusing of the search box at startup
- Introduced the Railroad Plugin by Astrid Elocson (see it in action in the new Filter Syntax documentation)
- Migrated functionality of "Sticky Titles" theme into an optional tweak for the "Vanilla"/"Snow White" themes. This means that tiddler titles will stick to the top of the window during scrolling on browsers that support
position: sticky(such as Safari and Firefox) - Added icons to $:/AdvancedSearch, $:/ControlPanel and $:/TagManager
- Changed wording of tiddler "save" button to "confirm"
- Added automatic linking of system tiddlers such as $:/ControlPanel
- Improved new tag dropdown to only list title matches
- Added a warning banner notifying the user when modified plugins require the page to be reloaded
- Added first pass at "stacked" story view
- Changed modal headers and footers to be parsed in inline mode by default (avoiding unneeded
<p>tags)
Hackability Improvements
- Added resolvepath Macro
- Added class attribute to CheckboxWidget
- Added support for a special message to be displayed when the main story river is empty
- Improved font rendering under Mac OS X
- Added support for embedding ZIP files
- Added support for custom elements with the RevealWidget
- Added style attribute to RevealWidget
- Fixed text inputs to use palette colours
- Several new core icons:
Bug Fixes
- Fixed the sameday Operator and eachday Operator to accept TW5 date strings
- Fixed version number compatibility checks for plugins
- Fixed problem with repeatedly cancelling a draft
- Improved sandboxing of generated
<iframe>elements - Fixed problem with modal backgrounds on Firefox
- Fixed problem with accidentally dragging a tiddler within its originating window
- Fixed problem with dragging certain plugins with Safari
- Partially fixed problem with SVG icons being clipped by 1 pixel on the right and bottom
- Fixed problem with double quotes in a new field value
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Fixed Highlight Plugin to work when generating static files under Node.js
- Fixed problem with case-insensitive filing systems (eg Windows)
- Added mobile metadata to static page templates
- Added added "noclean" parameter to RenderTiddlersCommand
- Added editions Operator and editiondescription Operator for enumerating available editions
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Major Improvements
New "Powered by TiddlyWiki" plugin
An experimental plugin to add a simple "Powered by TiddlyWiki" banner to your site. It is included in this prerelease but will not be on the main tiddlywiki.com wiki.
New "Fluid story, fixed sidebar" mode
It is now possible to arrange the main window so that the sidebar has a fixed width and the story river expands to fill the remaining space.
To switch it on, visit Theme Tweaks in the $:/ControlPanel Appearance tab and use the following options:
- Sidebar layout:
- Fixed story, fluid sidebar (default) - the story river has a fixed width and the sidebar fills the remaining space
- Fluid story, fixed sidebar - the story river expands to fill horizontal space remaining after the fixed width sidebar
- Sidebar width:
- The width of the sidebar. Can be specified in pixels (eg 350px), a percentage (eg 25%) or other CSS unit
Toolbar Button Style Setting
A new setting in $:/ControlPanel Settings tab allows the toolbar button style to be chosen from the following options:
- the existing style
- , which adds a thin border box around the button
- , which rounds the button corners and inverts the button colours
Plugins can add new style options.
New Tiddler Toolbar Button: "Open in new window"
An experimental new tiddler toolbar button opens a single tiddler in a separate pop-up browser window. The tiddler will be dynamically updated just as in the main window. There are several uses:
- Arranging reference tiddlers for easy access while editing in the main window
- Making good use of multi-screen layouts
- Printing the content of a single tiddler
- Running presentations in a separate window while maintaining notes in the main window
Improvements for visually impaired users
- Improved monochrome palette variants:
- . Foreground: , Background:
- . Foreground: , Background:
New "Solar Flare" palette
There's a new core palette "Solar Flare", contributed by Rustem Akbulatov (@nameanyone).
Options for Story Control
There are new options for controlling the position in the story river of newly opened tiddlers. Visit the Settings tab of $:/ControlPanel and look for "Tiddler Opening Behaviour".
New Hidden Settings
Two new hidden settings for advanced configuration:
New Vars widget
Added VarsWidget for setting multiple variables in one operation:
<$vars greeting="Hi" me={{!!title}} sentence=<<helloworld>>>
<<greeting>>! I am <<me>> and I say: <<sentence>>
</$vars>Other Improvements
Translation Improvements
- Updates to the Dutch, Chinese, Italian and German translations
- New Catalan (Spain) translation
Usability Improvements
- Added new page control icon for setting the palette:
- Added new icons for palette and "open new window"
- Improved the theme icon to better match the new palette icon:
- Avoid glitch with autofocusing the search box in the plugin library
- Added information about TiddlyDesktop to Releases
- Stopped autosaving after cancelling an edit
- Added dropdown to edit template to allow existing field names to be selected
Hackability Improvements
- Updated to KaTeX version 0.4.3, with the following editions since the previous 0.2.0 release that was distributed with TiddlyWiki 5.1.8:
- Added support for some
\begin/\endenvironments, including support forarray,matrix,pmatrix,bmatrix,vmatrix, andVmatrix - Added support for optional
\sqrtarguments, e.g.\sqrt[3]{x} - Add support for
\phantom - Add
\#,\& - See the KaTeX GitHub page for full release details
- Added support for some
- Extended ActionSendMessageWidget for more flexible passing of named parameters via new
$nameand$valueattributes - Added styling for
<kbd>elements such as escape and enter - Added subtle new "pin stripe" pattern for page background -
- Added support for custom elements to the ButtonWidget
- Improved CodeMirror plugin to automatically refresh when a tiddler type changes
- Added new setting in $:/ControlPanel to render tiddler titles as links, which can be convenient for drag and drop
- Simplified detecting the preview pane with the tv-tiddler-preview Variable
- Improved automatic linking of system tiddler titles by restricting them to letters and the characters
/.-
Bug Fixes
- Fixed problem with special characters in field names
- Fixed static banner layout on mobile devices
- Fixed popups within the scrollable widget by adding
position: relative;to example scrollable widget styles
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
Here are the details of recent releases of TiddlyWiki5. See TiddlyWiki5 Versioning for details of how releases are named. Note that archived versions of release source files are available at https://github.com/Jermolene/TiddlyWiki5/releases
If you are using node.js, you can also install prior versions like this:
npm install -g tiddlywiki@5.1.13
(BetaReleases and AlphaReleases are listed separately).
Release 5.1.21
Released 10 septiembre 2019 at 15:23
See GitHub for detailed change history of this release
This is a bug fix release that resolves issues introduced in the recent Release 5.1.20.
Bug Fixes
- Fixed crash with ActionDeleteFieldWidget and a missing tiddler attribute
- Fixed edge cases where some tiddler lists were not valid when interpreted as a filter
- Fixed problem with too many alerts when upgrading a wiki containing an overwritten core module
- Reverted inadvertently switching on performance instrumentation
- Fixed bug with WikiText within field names
- Fixed problem with classes in the Table-of-Contents Macros
- Fixed missing foreground colour for buttons with class
tc-btn-invisible - Fixed whitespace around field editor inputs
- Fixed layout problems with the translators edition
- Fixed crash with the External Attachments Plugin on Windows
- Removed inconsistent shadow for tag pills in the sidebar
- Fixed regression with the field Operator and blank operands
- Reverted erroneous change in v5.1.20 in the way that lists are stringified
- Fixed the Open sidebar tab to use the
tv-story-listvariable - Fixed problem saving to GitLab
Node.js Bug Fixes
- Fixed bug with customised tiddler file naming
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
| purpose | treating each input title as a number, return the remainder when divided by the numeric value of the operand |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers, but with each replaced by the remainder when dividing it by N |
New in: 5.1.20 See Mathematics Operators for an overview.
| purpose | remove a list of titles specified in the operand from the input |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to all |
| parameter | array = an array of items to remove |
| output | items removed from current list that appear at the head of the operand array |
! output | items removed from current list that appear at the tail of the operand array |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[remove[Tuesday Wednesday Thursday]]
[list[Days of the Week]] +[remove:3[Monday Wednesday Friday Saturday]]
[list[Days of the Week]] +[!remove:2{Days of the Week!!list}]
| purpose | filter the input titles by how they start, deleting that prefix |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | those input titles that start with S, but with those characters discarded |
In looking for matches for S, capital and lowercase letters are treated as different.
| purpose | filter the input titles by how they end, deleting that suffix |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | those input titles that end with S, but with those characters discarded |
In looking for matches for S, capital and lowercase letters are treated as different.
Render individual tiddlers identified by a filter and save the results to the specified files.
Optionally, the title of a template tiddler can be specified. In this case, instead of directly rendering each tiddler, the template tiddler is rendered with the "currentTiddler" variable set to the title of the tiddler that is being rendered.
A name and value for an additional variable may optionally also be specified.
--render <tiddler-filter> [<filename-filter>] [<render-type>] [<template>] [<name>] [<value>]- tiddler-filter: A filter identifying the tiddler(s) to be rendered
- filename-filter: Optional filter transforming tiddler titles into pathnames. If omitted, defaults to
[is[tiddler]addsuffix[.html]], which uses the unchanged tiddler title as the filename - render-type: Optional render type:
text/html(the default) returns the full HTML text andtext/plainjust returns the text content (ie it ignores HTML tags and other unprintable material) - template: Optional template through which each tiddler is rendered
- name: Name of optional variable
- value: Value of optional variable
By default, the filename is resolved relative to the output subdirectory of the edition directory. The --output command can be used to direct output to a different directory.
Notes:
- The output directory is not cleared of any existing files
- Any missing directories in the path to the filename are automatically created.
- When referring to a tiddler with spaces in its title, take care to use both the quotes required by your shell and also TiddlyWiki's double square brackets :
--render "[[Motovun Jack.jpg]]" - The filename filter is evaluated with the selected items being set to the title of the tiddler currently being rendered, allowing the title to be used as the basis for computing the filename. For example
[encodeuricomponent[]addprefix[static/]]applies URI encoding to each title, and then adds the prefixstatic/ - The
--rendercommand is a more flexible replacement for both the--rendertiddlerand--rendertiddlerscommands, which are deprecated
Examples:
--render "[!is[system]]" "[encodeuricomponent[]addprefix[tiddlers/]addsuffix[.html]]"– renders all non-system tiddlers as files in the subdirectory "tiddlers" with URL-encoded titles and the extension HTML
Genera un tiddler del ContentType que se especifique (por defecto text/html) y lo guarda con el nombre de archivo especificado
--rendertiddler <title> <filename> [<type>]Por defecto, el nombre de archivo es relativo al subdirectorio output en el directorio del wiki
Puede usarse el comando --output para dirigir la salida a cualquier otro directorio
Los directorios no existentes en la ruta del nombre de archivo se crean automáticamente.
Genera un conjunto de tiddlers de un determinado ContentType (por defecto text/html) y extensión de archivo (por defecto, .html), coincidentes con el argumento de un filtro
--rendertiddlers <filter> <template> <pathname> [<type>] [<extension>]Por ejemplo:
--rendertiddlers [!is[system]] $:/core/templates/static.tiddler.html ./static text/plainPor defecto, la ruta es relativa al subdirectorio output del directorio del wiki
Puede usarse con el comando --output para dirigir la salida a un directorio diferente
Cualquier archivo existente en el directorio de destino será borrado
Los directorios no existentes en la ruta del nombre de archivo se crean automáticamente.
| purpose | replace marker with N trailing items |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | marker = the item to be used as a marker |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] Last +[replace[Wednesday]]
[list[Days of the Week]] Last +[replace:2[Tuesday]]
[list[Days of the Week]] [[Yesterday]] [[Today]] [[Tomorrow]] +[replace:3[Tuesday]]
You can report bugs or problems with TiddlyWiki via our discussion groups. If you have a GitHub account then you can raise an issue there:
https://github.com/Jermolene/TiddlyWiki5/issues/new
Unless you are already familiar with GitHub, it's usually easiest to report problems through the discussion groups.
TiddlyWiki on GitHub
We use GitHub Issues to manage bug reports and feature requests for TiddlyWiki. To maintain their effectiveness we endeavour to have as few open issues as possible.
Policies for Managing Issues
Open issues should be actionable: generally either a reproducible bug report, or a specific feature request. From the perspective of the core developers, the issues list behaves like a shared todo list. Every item on the list requires a little bit of attention each time we check the list.
GitHub Issues are not very good for managing ideas that are not immediately actionable. Better to use the TiddlyWiki discussion groups for open ended questions, or speculative discussions of new features.
Creating Issues
Before creating a GitHub issue it is good etiquette to search through the existing issues to see whether the problem has already been reported. If a search isn't practical, don't worry too much; GitHub makes it easy to merge existing issues.
When you do create an issue, remember that for effective debugging, we need as much information as possible. At a minimum, please try to include:
- A descriptive title
- A summary
- Steps to reproduce
- Expected behaviour
- Context (OS, browser etc.)
Consider also adding screenshots if it makes things clearer.
There's a lot of good material on the web about bug reports:
The resolvepath macro takes a relative path and an absolute path. It interprets the former relative to the latter, and returns the absolute equivalent of the former.
Folders in the paths are delimited by /.
The special folder name . denotes the current folder, and .. denotes the parent folder.
If the absolute path indicates a folder, it needs to end with /. Anything after the final / is treated as an arbitrary filename within the intended path, and is discarded.
If no absolute path is supplied, the relative path is returned unchanged, except that anything after the final / is discarded.
The return value is a path, but does not end with /.
Parameters
- source
- the relative path
- root
- the absolute path
<<resolvepath "./backup" "http://example.com/store.php">><<resolvepath "backup" "http://example.com/store.php">><<resolvepath "../backup" "http://example.com/store.php">><<resolvepath "../jpg/Motovun_Jack.jpg" "http://example.com/resources/images/png/">><<resolvepath "../jpg/../png/Motovun_Jack.png">><<resolvepath "jpg/Motovun_Jack.jpg">>Páginas con recursos creados por la comunidad para ayudarte a sacarle todo el jugo a TiddlyWiki: Plugins, macros, utilidades y mucho más.
Envía más recursos que encuentres para ampliar esta lista via GitHub o Twitter, o publícalas en el grupo
"Font Awesome 5 Free SVGs for TiddlyWiki" by morosanuae
The Font Awesome 5 Free SVG images collection converted to tiddlers that you can easily import (drag'n'drop) in your wiki.
TiddlyDrive Add-on for Google Drive by Joshua Stubbs
An add-on for Google Drive that allows TiddlyWiki files stored there to be opened and saved directly
To find out how to add it to your account, go to the project's info page: https://lordratte.gitlab.io/tiddlydrive/#installation-guide
I made an app that lets one edit TiddlyWiki files saved in your Google drive and then saving them back automagically. The page is here https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo but I think you need to add it from the Google Drive web interface.
I even added an optional ability to save with ctrl + s hotkeys.
Joshua's launch post
Json Mangler plugin by Joshua Fontany
Extend tiddlywiki to parse complex ("nested") json data tiddlers.
Json Mangler introduces a new path syntax for indexes of json data tiddlers , and includes many supporting tools, filters, widgets, etc.
Example Wiki: https://joshuafontany.github.io/TW5-JsonManglerPlugin/
Source: https://github.com/joshuafontany/TW5-JsonManglerPlugin
Disqus comments plugin by bimlas
Use this plugin to give your visitors the opportunity to comment on your tiddlers without changing the wiki itself.
Disqus is a networked community platform used by hundreds of thousands of sites all over the web. With Disqus, your website gains a feature-rich comment system complete with social network integration, advanced administration and moderation options, and other extensive community functions.
Locator plugin by bimlas
For those who use many tags or store many different topics in a common wiki the Locator plugin is a table of contents widget and an enhanced search engine that gives you the opportunity to filter results by related tags. Unlike table of contents, standard search and list of tags, this plugin offers these features in an organic, collaborative way.
Kin filter operator by bimlas
The purpose of the kin operator with examples:
- Finds related tags, related tiddlers in any depth
- Finds out where base tiddler originates and what other elements originate from it
- Finds the ancestors and successors of a family member
- Finds the "leaves" of the branch of the base tiddler in a tree-like structure (where the base tiddler is a leaf)
- Finds the super- and subsets / groups of a mathematical set (where the base tiddler is a set)
"TiddlyWiki5^2 documenting while learning TiddlyWiki5" by Iannis Zannos
A wealth of hints, tips and notes about using TiddlyWiki on Node.js:
TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline.
The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web.
Also very cool is the treatment of tags as menus everywhere.
http://larigot.avarts.ionio.gr/users/iani/wikis/tw5square.html
Also available on GitHub (download and save index.html and open it in your browser).
Code styles and auto format settings for IDEs
Implementation of TiddlyWiki Coding Style Guidelines for different IDEs.
"TiddlyWiki Toolmap" by David Gifford
A topical index of known plugins, tutorials, themes, and other helpful tools for TiddlyWiki.
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Some of the topics indexed so far include:
- Background images and background colors
- Breadcrumbs
- Business - examples
- CSS / Styles, general
- Calendars, dates and timelines
- Checklists
- Collaboration
- Color palettes
- Colors
- Data visualizations
- Developer / advanced tools
- Diplay tiddlers horizontally
- Dropdowns
- Educational
- External files
- Fields
- Fonts
- Fun and games
- Home and lifestyle
- IFrames and embedding media
- Image galleries, modals and lightboxes
- Images, icons, emojis
- Importing and exporting between TiddlyWiki files
- Includes scaffolding within a tiddler, dragging to reorder tiddlers, choosing the number of columns
- Interfacing with, importing and exporting to and from other formats
- Knowledge bases, dictionaries and glossaries
- Layout/UI
- Lightboxes
- Links, linking
- Lists and filters
- Maps and geography
- Masonry, scaffolding
- Math
- MindMapping
- Mobile tools
- Music and sound
- Navigation
- node.js
- Note-taking
- Open the "filter" tab
- Partially hidden tiddlers
- Personal websites (examples)
- Presentations and slideshows
- Printing
- Project management
- Publishing and hosting TiddlyWikis on the web
- Searching tools
- Security and backup tools
- Social media, sharing, comments
- Spreadsheets and math
- Startup
- Sticky titles
- Story and screenplay creation
- Table of contents
- Tables, charts and graphs (cf data visualizations)
- Tabs
- Tags, tagging
- Task management and productivity - to do lists
- Themes
- Understanding TiddlyWiki
- Writing and editing
"Timimi" Extension and executable by Riz
Timimi is a Web Extension and executable for Firefox, Chrome and Chromium that allows it to save standalone TiddlyWiki files.
https://github.com/ibnishak/Timimi
This is an addon using native messaging, essentially handing over the contents to a webextension host (executable) which does the actual saving. Once installed, you can save the standalone TW from anywhere in your hard drive without any more interactions, like the original Tiddlyfox addon.
TW5-SingleExecutable by Jed Carty
TiddlyWiki5 Packaged with the multi-user plugin in a single executable file.
https://github.com/OokTech/TW5-SingleExecutable
Tiddlywiki, node js, multiuser plugin - all packaged into a single file so user can just download the file and run it and not have to install anything else. Versions available for windows, osx, and linux.
Widdly by Opennota
A cross platform server application that can save tiddlers to a local database
https://github.com/opennota/widdly
a minimal self-hosted app, written in Go, that can serve as a backend for a personal TiddlyWiki.
"Dynamic Tables" by Jed Carty
Dynamic Tables is a set of macros that allow you to create tables where the rows are created from tiddlers and the columns from the tiddler fields, or where the columns are created from tiddlers and the rows from their fields. Individual cells can be edited on the fly. Row tables can be sorted by columns and column tables can be sorted by rows.
"ATWiki" by Lamusia Project
A desktop application for TiddlyWiki, running on Windows.
https://lamusia.github.io/#ATWiki
TiddlyWiki for Windows. A unique non-linear notebook for capturing, organising and sharing complex information.
"muritest" by Simon Huber
A terrific demo of drag and drop, pan and zoom, and other sophisticated touch effects. Based on the muuri plugin by Uwe Stuehler.
Plugins by Uwe Stuehler
A collection of plugins from Uwe Stuehler, including:
- Material Edition, a theme based on Google's "material" design language
- A wrapper for the MUURI plugin, bringing complex "masonry"-style layouts to TiddlyWiki
"file-backups" Extension for Firefox by pmario
An extension for Mozilla Firefox that smoothes out some of the friction from TiddlyWiki's built-in HTML5 fallback saver, making it almost as easy to use as TiddlyFox. The workflow is intended to work out of the box, without configuration.
https://github.com/pmario/file-backups which contains links to the documentation and introduction video(s).
A chrome version is planned!
"Tekan: Kanban that stays with you" by Riz
A Kanban implementation for TiddlyWiki with a familiar look and feel (see the demo).
https://ibnishak.github.io/Tesseract/projects/tekan/Tekan.html
This is Tekan, a TW based kanban. The easiest way to know tekan is to use it. So let us begin, shall we?
"X3DOM for TiddlyWiki 5" by Jamal Wills
An experiment to embed interactive 3D graphics within TiddlyWiki by Jamal Wills. It is based X3DOM, an open source JavaScript library.
TiddlyServer by Arlen Beiler
An extension to the Node.js configuration of TiddlyWiki that adds support for static attachments and for working with multiple wikis at the same time.
https://github.com/Arlen22/TiddlyServer
TiddlyServer 2.0 takes the server command of TiddlyWiki on NodeJS and adds it to a static file server. This means you can load and serve any TiddlyWiki data folder in the same way you can serve a single file TiddlyWiki.
But you don't need to serve files and folders from just one place, you can serve them from multiple places anywhere on your harddrive (literally anywhere NodeJS can stat, readdir, and readFile). You can even organize them into virtual folders (aka aliases in Apache and mounts in Express).
The main point, of course, is that you can actually edit your files, not just look at them. Single file TiddlyWikis use the put saver, which needs to be patched using a bookmarklet included on the index page. The instructions for this are below under the heading "One thing that needs to be noted".
And, of course, you can edit data folder tiddlywikis just like you were running node tiddlywiki.js data –server, except that you run it on the path that you found it at (e.g. http://localhost/personal/notes/). You can have as many data folders open as you want, they don't conflict (though they will each take memory).
Data folders store individual tiddlers instead of entire wikis. They take less disk space as they also do not store the core and plugins. This means they also save much quicker, especially over the internet. They also save immediately (within 10 seconds or so) and they save drafts.
"Noteself" by Danielo Rodríguez
NoteSelf is your personal, private, customizable, Evernote-like experience. You want cloud? Fine! You don't? Fine too! It's all yours, It's your decision! Why not be a bit selfish?
NoteSelf is the perfect place to store your ideas, notes, thoughts, tips, tricks, recipes... whatever you want to put into it! NoteSelf will store, index, and make it easily searchable, so you will find it instantly whenever you need it!
You already know and love Evernote, we know it. It is comfortable, it syncs, has search capabilities... Wow, it's almost perfect, but what about:
- Privacy - Everything is stored on the Evernote's servers!
- Customization - If you don't like the interface of Evernote, there's nothing you can do
NoteSelf is built on top of TiddlyWiki, a powerful, free, highly customizable and open-source personal wiki. We took the best of it, it's powerful customization system, and mixed it with one of the best embedded databases available, PouchDb, for bringing the synchronization capabilities you need.
"savetiddlers" Extension for Chrome and Firefox by buggyj
An extension for Google Chrome and Mozilla Firefox that smoothes out some of the friction from TiddlyWiki's built-in HTML5 fallback saver, making it almost as easy to use as TiddlyFox once it is set up correctly.
"Dropboard" by Reid Gould
A TiddlyWiki plugin for kanban-like organization in the style of Trello™ using boards, lists, and cards.
Full Text Search Plugin by Rob Hoelz
A plugin to integrate the popular lunr.js search engine, giving TiddlyWiki much more sophisticated search capabilities:
https://hoelz.ro/files/fts.html
Provides an alternative search result list that orders results by search relevance and ignores differences in word forms (ex. tag vs tags).
On my personal wiki, I have the problem that there are terms I use across a lot of tiddlers, and sometimes I'll use different forms (such as the aforementioned tag vs tags). I wanted a plugin to allow me to find the tiddler I'm looking for quickly and didn't require me to worry about how I declined a noun or inflected a verb - so I wrote this plugin, which provides an alternative search list powered by lunr.js.
"JD Mobile Layout plugin" by JD
A plugin that improves the usability of TiddlyWiki on smartphones by JD:
"MathCell" by Stephen Kimmel
Mathcell allows spreadsheet-like abilities in a completely contained TiddlyWiki.
http://mathcell.tiddlyspot.com/
Mathcell allows spreadsheet-like abilities in a completely contained TiddlyWiki. Additional abilities allow it work as a general math engine.
"Wikilabs" by PMario
A collection of references for testing concepts around TiddlyWiki 5...
This is PMario's playground with ramblings about TiddlyWiki and related stuff.
It basically is a "jump off" page to various TiddlyWiki sites, that show editions, themes and plugins.
Tinka by Andreas Hahn
The Tinka plugin provides the ability to create and modify plugins in the browser, without requiring the use of Node.js.
See https://github.com/TinkaPlugin/Tinka for the GitHub repo.
https://tinkaplugin.github.io/
This is a Control Panel extension that aims to simplify the plugin creation and editing process. After installing, you will find a new tab in your control panel that makes creating and modifying plugins a little bit easier.
Leaflet maps plugin by Sylvain Comte
A mapping plugin based on Leaflet library. Allows you to create maps based upon geographical data contained in tiddlers.
http://sycom.github.io/TiddlyWiki-Plugins/#Leaflet%20plugin
The leaflet plugin is a (working) attempt to integrate the leaflet library in TiddlyWiki in order to display geographical purpose tiddlers.
For now
<$leafmap>widget displays an interactive map. Select size, location and zoom, clustering distance, and background. You can display data : geojson, point(s), polygon(s) and/or polyline(s) directly or calling GeoTiddler(s). Tiddler can be called individually, by list or with a filter.Have a look at demo page on the web.
"Slides and Stories" by Jan
Slides and Stories is a repository of the tools to optimize TW for scientific research and for presenting and publishing results.
http://slidesnstories.tiddlyspot.com
SlidesnStories
...is a tool to save and reload sets of Tiddlers. This is already working, The aim is to develop a mechanism to transform these into instant slideshows.
MetaTabs
is a tool which gives you the possibility to attach and show specific information in tabs at the bottom of each Tiddler: ideas, notes, tasks, stories and presentations, comments, annotations and footnotes.
It is inspired by MagicTabs and Tiddlyscholar by Alberto Molina Pérez, which are very elaborated tools that alas do not seem to be in active development any more. I wanted to change the behaviour in some ways. For example I wanted show tabs only if they have content....furthermore there is
- an export-plugin,
- a footnote-plugin,
- and a plugin to rearrange Tiddlers in the StoryRiver
"TiddlyWiki Knowledge Network" by Dmitry Sokolov
A Knowledge Network about TiddlyWiki.
http://confocal-manawatu.pbworks.com/w/page/113574373/TiddlyWiki
Interconnected with the visual taxonomy at every node: http://debategraph.org/Stream.aspx?nid=457381&vt=bubble&dc=focus
TWKN will be transferred into TWederation/TiddlyMap format as soon as I am convinced in reliable and secure versioning and multi-user operation in TW format. Your assistance and support would be highly appreciated.
"Cardo - Task and Project Management Wiki" by David Szego
Task & Delegation Tracking, Meetings & Agenda Items, Project Roles, Progress & Status Updates, Reference Items, Tickler Calendar, Conversation Logging, Book Notes & Library, and More!
Cardo is a standalone, browser-based tool that can be used as a simple task manager, or as a complex Project Management system (and indeed, I do use it this way in my daily work) as well as a fully Wiki-ized personal knowledge store. It runs completely independently in the browser, even without an Internet connection, making it possible to carry around on a USB stick, or to use on the morning commute.
"TB5 - a pocket full of tips" by Tobias Beer
An enormous collection of tips beautifully curated by Tobias Beer. It is actually a collection of sites, with sub-sites dedicated to topics such as filtering (http://tobibeer.github.io/tw/filters/).
http://tobibeer.github.io/tb5/
A collection of references and sandbox for testing concepts around TiddlyWiki 5...
"TiddlyServer" by Matt Lauber
TiddlyServer is a special purpose Desktop app, designed to facilitate managing multiple instances of TiddlyWiki running as a server. It does not require internet acess to access the wikis.
https://github.com/mklauber/TiddlyServer/releases/
TiddlyServer can import both TiddlyWiki files and TiddlyFolder wikis. For each wiki, you specify a prefix to serve it with and the source to import from. It will copy the wikis to its own internal store and begin serving them up at http://localhost:8080/{prefix}/. The export button for each wiki will convert it to a single file wiki.
"Hacks" by Thomas Elmiger
A collection of helpers by Thomas Elmiger, among them a tweet button macro, a text-stretch solution, a snippet extraction macro and a tiddler that installs a scroll-to-top button via drag-and-drop.
Quick Extensions for TiddlyWiki 5 – […] As I take from the community, I am happy if I can give back. You can use my stuff to do whatever you like, but remember to save a back-up first.
Thomas
"Ghostwriter theme by Rory Gibson" adapted for TW5 by Riz
An adaption of the "Ghostwriter" theme for TiddlyWiki.
https://ibnishak.github.io/ghostwriter/
Ghostwriter is a popular, minimalist and mobile responsive theme for the blogging platform ghost. This is an adaptation for TiddlyWiki.
"TiddlyWiki5 Forum on Reddit" by Riz
A TiddlyWiki5 forum on Reddit.
https://www.reddit.com/r/TiddlyWiki5/
A TiddlyWiki5 forum on Reddit. As of 2016, it claims to have the most up-to-date list of plugins available for TW5.
"Moments: A little color won't hurt" by Riz
An adaption of the "Moments" theme for TiddlyWiki.
http://tesseractmoments.surge.sh/
Moments is a beautiful free and responsive theme available for wordpress from here: http://www.s5themes.com/theme/moments/. This is an adaptation of the same for TW5 platform. All the design credits goes to the site and the original designer. If TW5 is going to be here for 25 years, might as well suit up.
"How Does Twederation Work" by Jed Carty
An explainer about Twederation, a system of sharing information between TiddlyWiki instances.
TWederation is a system for sharing information between participating TiddlyWikis without using a client-server model. The link here points to a tiddler that gives more details. This particular implementation works something like an online forum. On the rest of the site, you can follow discussions by the developers and collaborators occurring within the Twederation "network" itself.
"Gospel Bubbles" by Rev. David Gifford
Creates bubble maps of Biblical texts.
http://giffmex.org/gospels.bubbles.html#Gospels%20Bubbles
This TiddlyWiki, which is still under construction, has several features that together make it lightning fast to find passages, types of passages, themes, people, places and images in the New Testament Gospels. The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
- The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
- See how the different types of passages are distributed throughout each Gospel.
- Hover over passages to see the verses and titles.
- Click on a passage to open it and see the themes and other data it mentions.
- The themes by passage indexes are lists of the passages in each Gospel, followed by the themes and other data found in the passage. Clicking on a theme calls up a list of all the passages that mention that theme.
- The indexes of themes contain lists of links to each theme, person, group, place and image. Clicking on a theme calls up a list of all the passages that mention that theme.
- There is a search window hidden in the right hand menu. Use the search window to find passages quickly, by typing things like sower or paralytic. Click the arrows in the upper right of the screen to open the menu and search.
"Filter Examples" by Tobias Beer
This wiki gives examples for various filters and their use in the list widget
http://tobibeer.github.io/tw/filters/#Filter%20Examples
This wiki gives examples for various filters and their use in the list widget. A good starting point to understand what filters yield which results also is test-filters.js.
"SK Plugins" by Stephen Kimmel
A collection of plugins by Stephen Kimmel, including a number of additional editor toolbar buttons.
http://skplugins.tiddlyspot.com/
In keeping with the general spirit of the TiddlyWiki community, ie, you develop something useful and/or potentially interesting you share it with others, I'm sharing some of the plugins I've developed to go with the new Editor Toolbar. You'll find them and a more extensive discussion of what each does at http://skplugins.tiddlyspot.com/
"Mal's Sandbox" by Mal
A collection of extensions by @malgam
http://malsandbox.tiddlyspot.com
The "loadnew" plugin provides the JavaScript module $:/plugins/malgam/loadnew/loadnew.js that implements an incremental load command for Tiddlywiki 5.
The javascript code is based on the built-in module $:/core/modules/commands/load.js that loads tiddlers from a Tiddlywiki file into a node.js Tiddlywiki instance. This command loads all non-system tiddlers, irrespective of whether they have been modified since last loaded. As a result, all tiddlers in the node.js tiddlers folder will end up with a new modification date.
In contrast, the loadnew command only loads tiddlers that either don't already exist in the tiddlers folder, or have a newer modified date than the existing tiddler.
With a backup strategy that uses a file system snapshot process to preserve historical versions of tiddlers, the loadnew command minimises the sizes of the resulting snapshots.
twproxy by Steve Gattuso
An authentication proxy for your TiddlyWiki.
https://github.com/stevenleeg/twproxy
One of my favorite aspects of TiddlyWiki has been that it's web-based, making it possible for me to access my wiki from everywhere (especially my phone). That being said, I'm a bit paranoid, so I was left a bit unsatisfied with the tiddlywiki server's HTTP basic auth for protecting my wiki. ~23 commits later, I've created something called twproxy that I'd like to share with you all today, as I'm hoping somebody other than myself will find it useful.
Essentially it is a simple proxy that puts your wiki behind a username, password, and optional 2-factor auth prompt. This gives you added security in addition to the ability to remember your credentials past one browsing session (I was getting sick and tired of typing my username/password in over and over using basic auth).
TiddlyWiki extensions for Sublime Text 3 by roma0104
Sublime Text 3 syntax file for TiddlyWiki5 *.tid files.
TiddlyChrome by Arlen Beiler
An extension application for Google Chrome that enables TiddlyWiki to save changes directly to the file system.
TiddlyWiki Video Tutorials by Francis Meetze
Exhaustiva y recomendada serie de tutoriales para empezar a moverte cómodamente con TiddlyWiki. https://www.youtube.com/playlist?list=PLzZCajspPU_UjFn0uy-J9URz0LP4zhxRK
Estos tutoriales están pensados para darte las nociones básicas que te permitan empezar de inmediato a usar TiddlyWiki. Echamos una rápida mirada a la tecnología detrás de TiddlyWiki y a cómo instalarlo y crear tu primer Tiddler.
"TiddlyWiki for Scholars" by Alberto Molina
Edición de una versión anterior de TiddlyWiki, adaptada para la toma rigurosa de notas académicas.
http://tw5.scholars.tiddlyspot.com/
TiddlyWiki for Scholars es una customización personal de TiddlyWiki 5.0.13-beta que hice para tomar notas de lectura, pero que puede servir también a otros fines La idea subyacente en esta adaptación es la de poder crear y mostrar información relacionada con el tiddler que se visualiza, sin tener que salir de él para hacerlo.
datepicker plugin based on Pikaday, by kixam
An interactive date picker plugin based on Pikaday. A demo can be found here: http://kixam.github.io/TW5-datePicker/.
datepicker is a TiddlyWiki plugin that allows you to use a widget much like EditTextWidget to pick a date, and optionaly a time. It shows a nice interactive mini-calendar when clicked, allows you to set a date format for display, and is compatible with core date fields such as
modifiedandcreated.
TWCommunitySearch
The CommunitySearch wiki aggregates many public wikis from the community. It is updated automatically every day. At the time of writing, more than 5000 tiddlers are indexed, thus giving access to the largest known collection of TW content.
It lets you search for some specific content among a preselected list of wikis. The indexed content is mostly focused on TW usage, so you would typically use this search system to find information about a particular aspect of TiddlyWiki. Say for example that you want to learn how to make a table of content, type "table of content" in the CommunitySearch box (also accessible in the default tiddler GettingStarted). The search results are links to various wikis, and point directly to the specific tiddlers containing your request.
The CommunitySearch wiki also lets you:
- Browse the list of wikis
- Browse the list of author
- Browse the list of plugins
- Access content by tag (see also BookmarkingTags)
- Follow the latest news from the community (and publish your own news if you are a wiki author)
TiddlyWiki Jingle by Måns Mårtensson
A catchy jingle for TiddlyWiki.
https://musescore.com/node/796056
Even if it sounds like some ol' jazz tune it IS an original composition and it should be quite obvious that the "hook of the melody" is a trill made by singing Tidd-ly Wiki :-).
My lacking skills for writing text/lyrics should be apparent in the fact that the text consists of 12 Tidd-ly Wikis and some extra "tiddly's" - just for the sake of getting the message delivered ;-)...
I've recorded every instrument on my guitar via a guitar synth on a loop machine (except for the drums - they were played live/in sync with the loop station on a "BeatBuddy" drum pedal..) - no pc was involved..
rboue's plugins for TiddlyWiki
Featuring plugins that integrate two interesting new capabilities:
- SocialCalc providing a powerful spreadsheet
- Three.js providing interactive 3D graphics
I developed some plugins related to engineering tasks.
After using them for personal projects I'm glad to share with TiddlyWiki community.
"Encrypt single tiddler plugin" by Danielo Rodriguez
A plugin that allows to encrypt your tiddlers individually Danielo Rodriguez.
http://danielorodriguez.com/TW5-EncryptTiddlerPlugin/
Advantages:
- You can specify a different password for each tiddler if you want.
- You don't have to encrypt your whole wiky.
- If you forget your password, you only lose a tiddler.
- It's possible to edit the tiddler content , tags and fields except the encrypt field after encryption.
- [...]
TWaddle by Matias Goldman
A collection of hints and tips, musings and proposals from long-time TiddlyWiki contributor Mat Goldman.
http://twaddle.tiddlyspot.com/
This is Mat's, a.k.a <:-) little man-cave in the TiddlyVerse.
Most TW development is, understandably, based on the premise that "Improve code ➔ Better TW". TWaddle is also about developing TW but from the perspective that Bigger community ⇄ Better TW. Thus, TWaddle looks more to people issues - how to attract them, how to make them stick with TW etc.
I'm not a programmer but I am a TW enthusiast so I tiddlefiddle enough to make the occasional discovery of something cool. Given the amount of words I utter, it is also a mere numbers game before I say something that makes sense. TWaddle is intended to capture these eventualities.
vis.js Timeline by emkay, revived by kixam
An interactive timeline visualisation plugin based on Vis.js. A demo can be found here: http://kixam.github.io/TW5-visjsTimeline/.
vis.js Timeline is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable timelines. This project is a direct continuation of emkay's plugin.
SeeAlso by Matias Goldman
A simple technique for adding tag-based cross references to the default view template.
See also: - is a feature to generate a "See also:" section after the tiddler text, somewhat like in Wikipedia articles.
Ace Editor Plugin by Joerg Plewe
A plugin to integrate the Ace editor into TiddlyWiki.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
IndexedDB Plugin by Andreas Abeck
A plugin that allows changes to be synchronised with the IndexedDB database that is built-in to most browsers.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
"TW5-TeXZilla" plugin by Joe Renes
An alternative LaTeX plugin for TiddlyWiki5. It supports a wider set of LaTeX commands than KaTeX, though not as extensive as MathJax
http://tw5-texzilla.tiddlyspot.com
This plugin provides LaTeX support in TiddlyWiki5, using the TeXZilla latex parser to generate MathML.
Only Firefox and Safari support MathML at the moment, so the plugin is only useful if you're using one of these browsers. It might be possible to combine this plugin with MathJax to convert MathML to something that other browsers can understand, e.g. HTML+CSS, but I haven't tried this.
"GSD5" by Roma Hicks
An adaptation of the TiddlyWiki powered GTD® system formerly known as MonkeyGTD for TiddlyWiki version 5.
GSD5 is a Getting-Thing-Done tool for TiddlyWiki5 based off the mGSD classic TiddlyWiki.
"Heeg.ru" by sini-Kit
A guide in Russian to creating an online shop with TiddlyWiki. No serverside code is needed, instead orders are handled by Disqus.
TiddlyMap Plugin by Felix Küppers
An interactive network visualisation plugin based on Vis.js. A demo that also contains installation instructions can be found here: http://tiddlymap.org. The plugin's GitHub repository can be found here.
TiddlyMap is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable graphs. By creating relations between your topics you can easily do the following:
- Create concept maps and quickly manifest your ideas in tiddlers.
- Create task-dependency graphs to organize and describe your tasks.
- Visualize your topic structures to get an immediate grasp of topics and relations.
In general you may create, visualize and describe any network-structure you have in mind.
"In My Socks" by Jed Carty
An extensive collection of hints and tips from Jed Carty.
http://inmysocks.tiddlyspot.com
I made this so that some of my friends with absolutely no coding experience could use some of the better features of TW5 without having to learn much. I am hopefully going to continue updating it as I learn new things. There isn't really anything here that isn't available in plenty of other places, but I figured that since I spent a while putting it together and people keep saying that TW needs more documentation I would post it here.
"TiddlyWiki guide FR" by Sylvain Naudin
A collection of tips and guides in French, introduced by this blog post:
http://sylvain.naud.in/post/2014/10/29/Ressources-pour-TiddlyWiki-5-%28FR%29
Ce guide de prise en main de TiddlyWiki vous permettra de débuter sur ce logiciel : rédiger du texte avec la syntaxe wiki, insérer des images, créer des Tiddler, faire une recherche, ajouter des fonctionnalités, et bien d'autres choses.. Bonne lecture ! Sylvain
"TiddlyWiki5 Bourbon" by mkt_memory
An extensive collection of tips and resources for users of TiddlyWiki in Japanese.
http://bacchus.ivory.ne.jp/bourbon/
TiddlyWikiをHTML5にしたTiddlyWiki5が正式にリリースされました。このTiddlyWiki5の使い方について、自分で試した機能を中心に解説します。
TiddlyWiki5は、非常に多機能なローカルWikiです。このブログに書いてあることは、TiddlyWiki5で出来ることのごく一部です。
"CouchDB Adaptor" by William Shallum
An adaptor to enable TiddlyWiki to sync changes with a CouchDB database.
https://github.com/wshallum/couchadaptor
CouchDB sync adaptor for TiddlyWiki 5. Requires TiddlyWiki >= 5.1.2.
Works in limited testing. Not sure how well it handles conflicts.
Eucaly's Tiddly World
I collect my tw5 creations on-line as http://eucaly-tw5.tiddlyspot.com/
Available Plugins :
- TitleMe - Return in-place tiddler title, to link / show / edit the source tiddler
- QuickJump - Quick jump to tiddlers in story list
- FlexWidth - Flexibly tweak sidebar width for TiddlyWiki 5 (Inspired by TW5 tristate Sidebar)
- MatchFilter - returns matching text instead of a list of the tiddlers from FieldFilter
- PopupTagger - TagBar / TagTable with popup list of tags (Inspired by MonkeyTaggerMacro for TiddlyWiki classic)
TiddlyClip by buggyjay
BuggyJay's TiddlyClip browser extension for Firefox permits clipping of text and graphics from web pages:
http://tiddlyclip.tiddlyspot.com
TiddlyClip allows parts of webpages to be clipped into a TiddlyWiki, and consists of two parts, the browser addon and the TiddlyWiki plugin. The addon is completely memoryless, any configuration is determined by the current TiddlyWiki that the user has select to work with (we say that the addon is docked to the TiddlyWiki). TiddlyClip is designed to work (in a basic mode) without configuration. Once the addon and plugin are installed, all the user has to do is select which TW to dock to.
Plugins by TheDiveO
A collection of plugins from TheDiveO.
TheDiveO's Third Flow plugin construction system:
The ThirdFlow plugin brings to you another way to develop customization plugins for TiddlyWiki 5. It is not enforcing a specific development flow, it simply tries to help you. Otherwise, it tries to stay out of your way.
TheDiveO's FontAwesome plugin:
The FontAwesome plugin supports embedding Font Awesome in TiddlyWiki 5. There is no need to install this font into your operating system in order to use it with TiddlyWiki 5. The font is already embedded in this TiddlyWiki 5 customization plugin instead, so nothing else to install.
"Wills Q&D gTD" by Matabele
Matabele's stylish and clean system for personal task management.
This is my work in progress version of TW5, incorporating various features and ideas as and when they intrigue me. To grab any feature you may wish to try, drag the listed tiddlers across to the dropzone of an empty TiddlyWiki 5.0.10-beta
"TWeb.at" by Mario Pietsch
A collection of TiddlyWiki resources from Mario Pietsch, with a focus on cloud deployments. Mario also maintains the German translation of TiddlyWiki.
My name is Mario Pietsch from Austria. I'm living near Salzburg.
This page, will be the portal to my TiddlyWiki, TiddlyWeb related content.
MathJax Plugin by Martin Kantor
An experimental MathJax plugin for TiddlyWiki version 5. As Martin says, the implementation is a bit of a hack but may be useful until we have a better alternative.
http://mathjax-tw5.kantorsite.net
Welcome. I have created plugin for TiddlyWiki 5 which allows you to use MathJax (math in TeX and MathML) inside TiddlyWiki 5. It's unofficial plugin and it doesn't follow general policy of TiddlyWiki as stand-alone solution but it works. So you can use it if you want.
"TiddlyWiki Notes" by James Anderson
Notes and tips by a developer working on writing TiddlyWiki plugins – including TWExe, a widget for running Windows scripts and executables.
"TiddlyWiki 舞" by Bram Chen
A translation of the tiddlywiki.com documentation from Bram Chen, TiddlyWiki's Chinese translator.
"Hosting TiddlyWiki5 on GoogleDrive" by Tony Ching
Tony Ching's quick guide for sharing TiddlyWiki with Google Drive.
https://googledrive.com/host/0B51gSXixfJ2Qb0I4R2M4MWJVMlU
Anyway your self-contained a non-linear personal web notebook can be hosted on Google Drive, a free cloud service from Google.com. Because TiddlyWiki5 now supports the Stanford Javascript Crypto Library (SJCL), you can encrypt your content from prying eyes (excluding the NSA of course)
"TiddlyWiki5 Coding" by Chris Hunt
Chris Hunt's detailed developer tutorials for getting started with writing widgets for TiddlyWiki.
These pages document aspects TiddlyWiki5 programming, sharing "lessons learned" to help developers to get started with TiddlyWiki5 customization and extension.
There are currently two articles in this wiki:
- A Simple Widget
- A More Complex Widget
"TiddlyWiki5 Playground" by Ton Gerner
Huge collection of customisations and tweaks from Ton Gerner.
http://tongerner.tiddlyspot.com/
I am a longtime user of TiddlyWiki Classic and still use it daily since you can't do everything in TiddlyWiki 5 (yet) ;)
I started experimenting with TW5 at the end of September 2013 (alpha10). Since I missed a few things in the layout I got used to in TiddlyWiki Classic 1, I started with modifying the layout of TW5. To share my knowledge, I made a few guides about these 'modifications'. The guides started as a non-linear personal web notebook (yeah, the subtitle of TiddlyWiki!). I started experimenting with layout things and used TW5 to document my experiments.
"BJTools" by buggyj
buggyj has created several useful plugins, including a WYSIWYG HTML editor, a configurable calendar and tag lists with draggable ordering.
"BrainTest - tools for a digital brain" by Danielo Rodriguez
A collection of customisations and macros from Danielo Rodriguez.
http://braintest.tiddlyspot.com/
This is my personal tiddlywiki file for testing.
Here I will post the tools and Macros that I develop for this awesome tool. That way, all the help the comunity gave me can came back to the comunity again.
"TW5 Magick" by Stephan Hradek
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
http://tw5magick.tiddlyspot.com/
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
"TiddlyWiki Posts" by Jeffrey Kishner
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists.
http://blog.jeffreykishner.com/tiddlywiki/
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
| purpose | discard the first N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | all but the first N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]rest[]]
[list[Days of the Week]rest[3]]
Z Y X W V U T S R Q P O +[rest[5]]
El Editor de currículum es una edición especial de ~Tiddlywiki concebida para la creación de manera sencilla de un currículum profesional que se puede imprimir o guardar en la web.
https://tiddlywiki.com/editions/resumebuilder/
(En inglés. Está en preparación la edición en castellano)
Introduction
The reveal widget hides or shows its content depending upon the value of a state tiddler. The type of the widget determines the condition for the content being displayed:
- type=match: the content is displayed if the state tiddler matches a specified value
- type=nomatch: the content is displayed if the state tiddler doesn't match a specified value
- type=popup: the content is displayed as a popup as described in the PopupMechanism
- type=lt: the content is displayed if the state tiddler contains an integer with a value less than a specified value
- type=gt: the content is displayed if the state tiddler contains an integer with a value greater than a specified value
- type=lteq: the content is displayed if the state tiddler contains an integer with a value less than or equal to a specified value
- type=gteq: the content is displayed if the state tiddler contains an integer with a value greater than or equal to a specified value
Content and Attributes
The content of the <$reveal> widget is displayed according to the rules given above.
| Attribute | Description |
|---|---|
| state | A TextReference containing the state |
| stateTitle | A title containing the state, without TextReference. Gets preferred over the state attribute |
| stateField | A field name which is used to look for the state, if the attribute stateTitle is present |
| stateIndex | An index which is used to look for the state, if the attribute stateTitle is present |
| tag | Overrides the default HTML element tag (<div> in block mode or <span> in inline mode) |
| type | The type of matching performed: match, nomatch, popup, lt, gt, lteq or gteq |
| text | The text to match when the type is match, nomatch, lt, gt, lteq or gteq |
| class | An optional CSS class name to be assigned to the HTML element » Set to tc-popup-keep to make a popup "sticky", so it won't close when you click inside of it |
| style | An optional CSS style attribute to be assigned to the HTML element |
| position | The position used for the popup when the type is popup. Can be left, above, aboveright, right, belowleft or below |
| positionAllowNegative | Set to "yes" to prevent computed popup positions from being clamped to be above zero |
| default | Default value to use when the state tiddler is missing |
| animate | Set to "yes" to animate opening and closure (defaults to "no"; requires "retain" to be set to "yes") |
| retain | Set to "yes" to force the content to be retained even when hidden (defaults to "no") |
Examples
Simple content reveal
Here's a simple example of showing and hiding content with buttons:
<$button set="$:/state/SampleReveal1" setTo="show">Show me</$button>
<$button set="$:/state/SampleReveal1" setTo="hide">Hide me</$button>
<$reveal type="match" state="$:/state/SampleReveal1" text="show">
! This is the revealed content
And this is some text
</$reveal>Este es su aspecto:
Accordion or Slider
An "accordion" or "slider" is a button that can be used to toggle the display of associated content.
<$reveal type="nomatch" state="$:/state/SampleReveal2" text="show">
<$button set="$:/state/SampleReveal2" setTo="show">Show me</$button>
</$reveal>
<$reveal type="match" state="$:/state/SampleReveal2" text="show">
<$button set="$:/state/SampleReveal2" setTo="hide">Hide me</$button>
! This is the revealed content
And this is some text
</$reveal>Este es su aspecto:
Popup
Here is a simple example of a popup built with the RevealWidget:
<$button popup="$:/SamplePopupState">Pop me up!</$button>
<$reveal type="popup" state="$:/SamplePopupState">
<div class="tc-drop-down">
! This is the popup
And this is some text
</div>
</$reveal>Este es su aspecto:
How to use text references with field content
Here is a simple example how to use text references with field content to control the RevealWidget. If the field jeremy is populated with text tiddlywiki, a message will be displayed.
<$reveal type="match" state="!!jeremy" text="tiddlywiki">
~TiddlyWiki!
</$reveal>Este es su aspecto:
TiddlyWiki!
| purpose | reverse the order of the input titles |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | the input, in reverse order |
There are still some areas of TiddlyWiki that have not been fully developed beyond the experimental stage:
- Multiple users with the client-server configuration
- Smartphone user experience
- New tiddler manager, including bulk operations like search and replace
- Federation that can run in the browser or under Node.js
- Improved editions
- Improved support for third party plugin libraries
Also see the issues list on GitHub: https://github.com/Jermolene/TiddlyWiki5
| purpose | rounds a list of numbers to the nearest integer |
|---|---|
| input | a selection of titles |
| output | rounds each of the input numbers to the nearest integer |
New in: 5.1.20 See Mathematics Operators for an overview.
Introducción
El modo seguro desactiva la mayoría de customizaciones en TiddlyWiki en caso de que, a fuerza de adaptaciones sucesivas, dejen de funcionar correctamente. Un caso frecuente es el de la actualización del núcleo, que muchas veces "rompe" las customizaciones del usuario, especialmente en versiones Beta.
Cómo activar el modo seguro
Modo seguro se activa al arrancar TiddlyWiki con el hash #:safe.
Cómo trabaja el modo seguro
Activar modo seguro produce los siguientes cambios en el funcionamiento de TiddlyWiki:
- Todos los plugins se desactivan temporalmente.
- Todos aquellos tiddlers que "puentean" tiddlers ocultos reciben el prefijo
SAFE:, lo que restaura los originales - Algunas opciones de configuración se ignoran y usan los valores por defecto.
Se muestra un informe de los tiddlers modificados por el usuario, de modo que pueden inspeccionarse en busca de fallos.
| purpose | filter the input by date |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a date field, defaulting to modified |
| parameter | D = a date, in the format YYYYMMDD |
| output | those input tiddlers in which field F has the value D, ignoring time |
If D is not a valid date, the output is empty.
D may include a time of day, but this is ignored.
[sameday[20140410]]
[sameday:created[20140410]]
This is a Level 1 Heading
This is a paragraph.
This is written as a Level 3 heading
This is written as a Level 4 heading
This is written as a Level 5 heading
This is a Level 2 heading
This is written as a Level 4 heading
This is written as a Level 5 heading
This is written as a Level 6 heading
This is written as a Level 3 heading
This is written as a Level 4 heading
This is written as a Level 5 heading
This is written as a Level 4 heading
This is written as a Level 5 heading
This is written as a Level 6 heading
Esta es una alerta de demostración.
Pinchando en el icono del cubo de basura se borra el tiddler que la contiene. Otra forma de librarse de ella es editar el tiddler Alerta de demostración y quitarle la etiqueta.
Saves individual tiddlers identified by a filter in their raw text or binary format to the specified files.
--save <tiddler-filter> <filename-filter>- tiddler-filter: A filter identifying the tiddler(s) to be saved
- filename-filter: Optional filter transforming tiddler titles into pathnames. If omitted, defaults to
[is[tiddler]], which uses the unchanged tiddler title as the filename
By default, the filename is resolved relative to the output subdirectory of the edition directory. The --output command can be used to direct output to a different directory.
Notes:
- The output directory is not cleared of any existing files
- Any missing directories in the path to the filename are automatically created.
- When saving a tiddler with spaces in its title, take care to use both the quotes required by your shell and also TiddlyWiki's double square brackets :
--save "[[Motovun Jack.jpg]]" - The filename filter is evaluated with the selected items being set to the title of the tiddler currently being saved, allowing the title to be used as the basis for computing the filename. For example
[encodeuricomponent[]addprefix[static/]]applies URI encoding to each title, and then adds the prefixstatic/ - The
--savecommand is a more flexible replacement for both the--savetiddlerand--savetiddlerscommands, which are deprecated
Examples:
--save "[!is[system]is[image]]" "[encodeuricomponent[]addprefix[tiddlers/]]"– saves all non-system image tiddlers as files in the subdirectory "tiddlers" with URL-encoded titles
Guarda un tiddler individual en formato binario o como texto plano con el nombre de archivo especificado.
--savetiddler <title> <filename>Por defecto, la ruta es relativa al subdirectorio output del directorio del wiki
Puede usarse con el comando --output para dirigir la salida a un directorio diferente
Los directorios no existentes en la ruta del nombre de archivo se crean automáticamente.
Guarda un grupo de tiddlers en formato binario o como texto plano en el directorio especificado.
--savetiddlers <filter> <pathname>Por defecto, la ruta es relativa al subdirectorio output del directorio del wiki
Puede usarse con el comando --output para dirigir la salida a un directorio diferente
Los directorios no existentes en la ruta del nombre de archivo se crean automáticamente.
This plugin causes TiddlyWiki to continuously download (as a JSON file) the contents of any tiddler that is manually changed by any of several means:
- Confirming an edit
- Deleting tiddlers
- Imports
- Renames/relinks
- Optionally, typing in draft tiddlers can trigger a download
Where appropriate, separate 'before' and 'after' files are downloaded. Configured correctly, the browser will download the files silently in the background, and they can be used as a backup in case of accidental data loss.
New in: 5.1.20 Saves the current wiki as a wiki folder, including tiddlers, plugins and configuration:
--savewikifolder <wikifolderpath> [<filter>]- The target wiki folder must be empty or non-existent
- The filter specifies which tiddlers should be included. It is optional, defaulting to
[all[tiddlers]] - Plugins from the official plugin library are replaced with references to those plugins in the
tiddlywiki.infofile - Custom plugins are unpacked into their own folder
A common usage is to convert a TiddlyWiki HTML file into a wiki folder:
tiddlywiki --load ./mywiki.html --savewikifolder ./mywikifolderMétodos disponibles para guardar cambios en TiddlyWiki
- TiddlyDrive
- TiddlyServer
- Noteself
- Timimi
- file-backups
- savetiddlers
- TiddlyDesktop
- Emergency Export
- Internet Information Services
- Guardar en Android
- Beaker Browser
- TiddlyDesktop
- Guardar en TiddlySpot
- Guardar en servidor php
- Guardar en iPad/iPhone
- Git Service Saver
- WebDAV
- Ruby Server
- TiddlyFox en Android
- Guardar en Firefox
- Guardar con módulo HTML5
- TiddlyWiki Cloud Connectors
- Guardar en Internet Explorer
- Guardar en Safari
El módulo incorporado de guardado en TiddlySpot también puede usarse para guardar cambios en un sencillo script de PHP que puede ejecutarse en la mayoría de proveedores.
- Descarga una copia de store.php de aquí
- Edita tu copia de store.php para incluir tu nombre de usuario y contraseña. Busca la línea
$USERS = array( 'UserName1'=>'Password1'...etcy sustituye Username1 y Password1 por los tuyos, respectivamente- Asegúrate de dejar intactos el código y su puntuación.
- Guarda los cambios
- Mediante FTP o web, sube el archivo store.phpal servidor. Asegúrate de que el nombre de archivo es correcto
- Si el archivo ha subido correctamente, lo verás en el navegador.
- En TiddlyWiki, ve a la pestaña Servidor del Panel de control e introduce la siguiente información:
- Tu nombre de usuario como nombre de wiki
- Tu contraseña
- La URL del archivo store.php, La URL del archivo store.php, no la del wiki
La pestaña Servidor del panel de control incluye las siguientes opciones de configuración:
| Nombre | Descripción |
|---|---|
| Dirección (URL) del servidor | URL completa del archivo store.php en el servidor |
| Nombre de archivo | Nombre de archivo usado para guardar el TiddlyWiki (por defecto index.html |
| Directorio de almacenamiento | Ruta relativa al archivo store.php del directorio usado para guardar el wiki |
| Directorio de copias de seguridad | Ruta relativa al archivo store.php del directorio donde se guarda la copia de seguridad del wiki. |
La aplicación para dispositivos Android AndTidWiki permite editar y guardar cambios en TiddlyWiki5, incluso al trabajar offline, sin conexión de red.
Nota: AndTidWiki es un proyecto independiente de TiddlyWiki
New in: 5.1.14 TiddlyWiki incorporates a saver module that allows it to save changes directly with the Beaker Browser, an experimental peer-to-peer browser.
Instructions
- Download and install the Beaker Browser from https://beakerbrowser.com/
- Run Beaker, and if necessary open a tab to beaker:start
- Click the "New site" button at the top left of the page
- Enter the details of your site
- Click the link “Add files” and upload your TiddlyWiki index.html file
- View the site by clicking on the link to index.html; it should open in a new tab
- Try out creating tiddlers, and saving changes
At this point, the wiki is entirely private, and other users cannot see the content even if they have the URL. To share the wiki with other users:
- Publish your changes
- Visit the "Library" page in Beaker Browser via the system menu
- Select your site in the list
- Look for a box mentioning "n unpublished changes". If not present, skip to the next step
- Click the "Review changes" button
- Click the "Publish" button
- Share the dat: URL
- Copy the URL of your site from the address bar and share it with other users
- Other users should be able to access your site but they won't be able to make changes unless they fork their own copy
Por defecto, TiddlyWiki guarda los cambios en InternetExplorer 10 y superiores usando un módulo de guardado que descarga el archivo modificado en vez de guardarlo directamente. Hay dos alternativas para guardar los cambios directamente en el archivo:
- Usando la extensión TiddlyIE
- Ejecutándolo como aplicación HTA cambiando la extensión
*.htmlpor*.hta
La aplicación para iPad e iPhone TWEdit permite editar y guardar cambios en TiddlyWiki5, incluso cuando se trabaja offline, sin conexión de red. Descárgala aquí.
Instrucciones de uso:
- Abre TWEdit
- Toca el título en el centro de la barra de herramientas en uso
- Aparecerá un cuadro de texto en el que puedes indicar una URL
- Escribe la URL
https://tiddlywiki.com/languages/es-ES/empty.html - Cuando se cargue el TiddlyWiki vacío, toca el icono Guardar (el segundo icono por la derecha, en la barra superior)
- Aparecerá un cuadro de alerta en el que debes indicar un nombre para el archivo local.
- Escribe el nombre que quieras usar para tu documento (siempre con la extensión
.html)
- Comprueba que funciona con el botón Nuevo tiddler de la barra lateral. Escribe algo en el tiddler y haz click en el botón OK
- Guarda ahora los cambios haciendo click en el botón Guardar cambios de la barra lateral.
- Aparecerá un mensaje de confirmación arriba a la derecha
Nota: TWEdit es un proyecto independiente de TiddlyWiki
Este método para guardar cambios es un poco rudimentario porque requiere intervención manual para cada acción de guardado.
- Descarga un TiddlyWiki en blanco pulsando este botón
Si el botón no funciona, guarda este enlace: https://tiddlywiki.com/languages/es-ES/empty.html
Seguramente el navegador te pida que confirmes la descarga
- Localiza el archivo que acabas de descargar
- Puedes cambiarle el nombre, siempre que mantengas la extensión
.htmlo.htm
- Puedes cambiarle el nombre, siempre que mantengas la extensión
- Abre el archivo en el navegador
- Crea un nuevo tiddler usando el botón Nuevo tiddler de la barra lateral. Escribe algo en él y haz clic en el botón OK
- Guarda los cambios con el botón Guardar cambios de la barra lateral
- Se mostrará una ventana emergente Descargar cambios, con un enlace con el nombre Clic-derecho para guardar cambios
- Haz clic con el botón derecho y selecciona Descargar destino como... (u opción parecida) en el menú desplegable
- Ve hasta la carpeta que contiene el archivo HTML de tu wiki y selecciona el archivo
- Clic en el botón Guardar
- Clic en Reemplazar para confirmar la sustitución del archivo existente
- Comprueba que los cambios se han guardado correctamente
See the Introducing TiddlyDesktop Video
- Install the latest release of TiddlyDesktop from https://github.com/Jermolene/TiddlyDesktop/releases
- Run TiddlyDesktop
- Use the browse button to open TiddlyWiki files
- Save changes within TiddlyWiki in the usual way
TiddlySpot es un servicio de alojamiento gratuito para documentos de TiddlyWiki hecho por Simon y Daniel Baird. La manera más sencilla de empezar a usarlo es registrarse en http://tiddlyspot.com. Por defecto muestra la última versión de TiddlyWiki Classic, pero es totalmente compatible con TW5
Puedes subir un documento de TiddlyWiki5 a TiddlySpot siguiendo estos pasos:
- Regístrate en http://tiddlyspot.com/ para poder crear un wiki y recuerda el nombre y la contraseña elegidos
- Abre tu copia local de TiddlyWiki en el navegador
- En la pestaña Servidor del panel de control, rellena los campos de nombre y contraseña en TiddlySpot
- Haz clic en el botón . Una notificación en la esquina superior derecha de la pantalla te confirmará el guardado. Guardar puede llevar algún tiempo, dependiendo de la velocidad de conexión y del tamaño del wiki.
- Navega hasta tu wiki en TiddlySpot: http://tuwiki.tiddlyspot.com/
Ten en cuenta que la contraseña se envía sin encriptar. Más información en http://faq.tiddlyspot.com/:
¿Es seguro TiddlySpot?
No. TiddlySpot no usa SSL/https. Tu contraseña se envía sin encriptar al guardar y al identificarte en un sitio privado. Esto significa que tu sitio en TiddlySpot es vulnerable al sniffing de paquetes y que tu contraseña puede ser vista por terceras partes malintencionadas. Los datos de tu sitio en TiddlySpot también se envían sin encriptar cuando accedes a tu sitio, aunque sea privado. Por este motivo te recomendamos que no incluyas en TiddlySpot información sensible como detalles bancarios y que no uses contraseñas que ya tengas en uso en otros sitios seguros.
Problemas al guardar en TiddlySpot
Si usas Firefox, es más que probable que tropieces con este error al intentar guardar tu wiki en TiddlySpot:
Error while saving:
Error:NS_ERROR_DOM_BAD_URI: Access to restricted URI denied
La operación de guardado falla por restricciones de seguridad de Firefox y está fuera de nuestro alcance. Hasta que se resuelva, nuestro consejo es que para guardar en TiddlySpot uses otro navegador, por ejemplo, Chromium:
- Abre tu wiki local con Chromium y repite los pasos 1 a 5 descritos más arriba
- Una vez hayas comprobado en Chromium que TiddlySpot ha alojado tu wiki correctamente, podrás acceder, editar y guardar con Firefox en la copia online.
- Después de subir tu archivo local por primera vez, podrás editar tu wiki y guardar cambios online con cualquier navegador moderno de tu preferencia.
- No olvides introducir los datos de tu sitio de TiddlySpot en Servidor cada nuevo navegador con el que quieras guardar cambios online
TiddlyWiki can save changes directly to a GitHub repository in the single file configuration.
Saving to a Git service is configured in the $:/ControlPanel in the Git Service Saver tab under the Saving tab. The following settings are supported:
- Type - (mandatory) the type of the service (e.g. GitHub, GitLab)
- Username - (mandatory) the username for the Git service account used for saving changes
- Password - (mandatory) the password, OAUTH token or personal access token for the specified account. Note that GitHub permits several different mechanisms for authentication
- Repository - (mandatory) the name of the Git repository. Both the owner name and the repository name must be specified. For example
Jermolene/TiddlyWiki5 - Branch - (optional) the name of the branch to be used within the Git repository. Defaults to
master - Path - (optional) the path to the target file. Defaults to
/ - Filename - (mandatory) the filename of the target file
Notes
- The Git service password is stored persistently in browser local storage. Be sure to clear the password if using a shared machine. Using a personal access token for authentication offers an extra layer of security: if the access token is accidentally exposed it can be revoked without needing to reset the account password
This is a minimal server using Ruby Webrick. It just serves up files from the same folder and handles saving.
Once running, just point your web browser at http://localhost:8000 to view the folder listing, and click on your wiki html file.
See the script at:
https://gist.github.com/jimfoltz/ee791c1bdd30ce137bc23cce826096da
If hosted on a WebDAV-enabled server, TiddlyWiki will automatically save changes via HTTP.
Servers
Many NAS or Subversion servers support WebDAV out of the box. Setting up your own server might take some effort though:
dav-server is a quick way to serve up a folder of HTML TiddlyWikis.
webdav server for Android lets you put wikis in your pocket. You can share with other devices on the local network too.
Existing Wikis
WebDAV support was added Feb 16 2016. If you created your wiki before that, you'll need to Upgrade to enable WebDAV.
Video HowTo's
Mario Pietsch has created several videos that show how to prepare Microsoft Internet Information Service (IIS) to host a local TiddlyWiki using WebDav
Free Hosting
Several WebDAV hosting services tested (box.com, swissdisk.com) don't support accessing HTML files via a webbrowser, so they won't work with TiddlyWiki. However, The GMX mediacenter (www.gmx.net) has been reported as working with WebDAV with a free account.
Este método para guardar cambios es un poco rudimentario porque requiere intervención manual para cada acción de guardado. Tiene, sin embargo, la ventaja de que funciona en casi todos los navegadores de escritorio y en muchos navegadores móviles.
- Descarga un TiddlyWiki en blanco pulsando este botón
Si el botón no funciona, guarda este enlace: https://tiddlywiki.com/languages/es-ES/empty.html
Seguramente el navegador te pida que confirmes la descarga
- Localiza el archivo que acabas de descargar
- Puedes cambiarle el nombre, siempre que mantengas la extensión
.htmlo.htm
- Puedes cambiarle el nombre, siempre que mantengas la extensión
- Abre el archivo en el navegador
- Crea un nuevo tiddler usando el botón Nuevo tiddler de la barra lateral. Escribe algo en él y haz clic en el botón OK
- Guarda los cambios con el botón Guardar cambios de la barra lateral
- El navegador descargará una copia del wiki que incluye tus cambios.
- Localiza el archivo nuevo y ábrelo en el navegador
- Comprueba que los cambios se han guardado correctamente
Consejo: la mayoría de navegadores permiten la opción de especificar la localización de cada descarga, en lugar de descargar a la carpeta por defecto. Esta opción te permite "planchar" tu archivo con la nueva versión.
Si usas Firefox para Android, las instrucciones que necesitas son estas.
- Comprueba que tienes la última versión de Firefox
- Descarga e instala la última versión disponible de TiddlyFox
- Reinicia Firefox
- Descarga un TiddlyWiki en blanco pulsando este botón:
- Localiza el archivo que acabas de descargar
- Puedes cambiarle el nombre, pero mantén la extensión
.htmlo.htm
- Puedes cambiarle el nombre, pero mantén la extensión
- Abre el archivo en Firefox
- Dale a OK cuando TiddlyFox te pregunte si quieres activar la función de guardado para el archivo
- Crea un nuevo tiddler usando el botón Nuevo de la barra lateral. Escribe algo en él y haz clic en el botón OK
- Guarda los cambios con el botón Guardar de la barra lateral
- Recarga la página para comprobar que se han guardado correctamente los cambios
También puedes consultar el video tutorial
- Asegúrate de que tienes la última versión de Firefox para Android
- Descarga e instala la última versión de la extensión TiddlyFox de:
- Instala esta extensión para poder guardar localmente el archivo TiddlyWiki:
- Descarga un TiddlyWiki en blanco guardando el enlace:
Para guardar el enlace, mantenlo presionado y selecciona "Save link" (asegúrate de tener instalada la extensión "save-link-menus")
- Cuando se haya descargado el archivo, haz click en él, bien en la barra de notificaciones, bien en el administrador de descargas.
- Para abrirlo, selecciona Firefox en vez del navegador por defecto de Android.
- Haz clic en OK cuando TiddlyFox te pregunte si quieres activar la función de guardado para el archivo.
- Comprueba que funciona con el botón Nuevo tiddler de la barra lateral. Escribe algo en el tiddler y haz click en el botón OK
- Guarda ahora los cambios haciendo click en el botón Guardar cambios de la barra lateral.
- Arriba a la derecha aparecerá una notificación en amarillo que dice Guardado
- Actualiza la ventana del navegador para comprobar que los cambios se han guardado correctamente.
- Descarga e instala la extensión TiddlyIE:
- Reinicia Internet Explorer. Se te preguntará si quieres activar TiddlyIE
Puede que también te pida activar Microsoft Script Runtime
- Descarga un TiddlyWiki en blanco pulsando este botón
Si el botón no funciona, guarda este enlace: https://tiddlywiki.com/languages/es-ES/empty.html
Seguramente el navegador te pida que confirmes la descarga
- Localiza el archivo que acabas de descargar
- Puedes cambiarle el nombre, pero mantén la extensión
.htmlo.htm
- Puedes cambiarle el nombre, pero mantén la extensión
- Abre el archivo con Internet Explorer
- Crea un nuevo tiddler usando el botón Nuevo tiddler de la barra lateral. Escribe algo en él y haz clic en el botón OK
- Guarda los cambios con el botón Guardar cambios de la barra lateral. Internet Explorer abrirá un cuadro de diálogo para que confirmes que quieres guardar el archivo localmente.
- Recarga la página para comprobar que los cambios se han guardado correctamente
The SavingMechanism is the mechanism by which TiddlyWiki generates a new HTML file and stores it. It is different from the sync mechanism, which is concerned with synchronising changes to individual tiddlers back to a server (see https://tiddlywiki.com/dev/#SyncAdaptorModules for more details).
The following steps are involved:
- The saver mechanism uses the filter defined in $:/config/SaverFilter to specify which modified tiddlers trigger the dirty state for the wiki. (The dirty state is reflected in the red colouring of the "save changes" button in the sidebar).
- The ButtonWidget is used to generate a tm-save-wiki message to trigger the save operation
- The optional parameter for the message specifies the template that will be used for generating the HTML file, defaulting to $:/core/save/all
- The plugin $:/plugins/tiddlywiki/tiddlyweb in the client-server configuration replaces the default template with $:/plugins/tiddlywiki/tiddlyweb/save/offline
- The template includes a variable assignment that specifies a filter to select the tiddlers that should be included in the saved file. It then transcludes the main page template
$:/core/templates/tiddlywiki5.html- The template includes a reference to
$(publishFilter)$that allows the filter to be customised via a global variable
- The template includes a reference to
- The tm-save-wiki handler renders the template to generate the HTML file
- The message handler chooses the highest priority "saver" module that can handle saving the file
- See https://tiddlywiki.com/dev/#Saver for more details
Puedes sentirte tentado de pensar que la arquitectura de página única de TiddlyWiki lo hace inadecuado para grandes cantidades de datos. La verdad es que los usuarios de TiddlyWiki suelen trabajar sin problemas con archivos de 20 ó 30 Mb... y se han hecho experimentos satisfactorios con archivos de varios Gb.
Script Files
The TiddlyWiki5 repository contains several scripts in the bin folder that you can use to automate common tasks, or as a useful starting point for your own scripts. See Scripts for building tiddlywiki.com for details of the scripts used to build and release https://tiddlywiki.com/.
All the scripts expect to be run from the root folder of the repository.
serve: serves tw5.com
./bin/serve.sh -h
./bin/serve.sh [edition dir] [username] [password] [host] [port]Or:
./bin/serve.cmd -h
./bin/serve.cmd [edition dir] [username] [password] [host] [port]This script starts TiddlyWiki5 running as an HTTP server, defaulting to the content from the tw5.com-server edition. By default, the Node.js serves on port 8080. If the optional username parameter is provided, it is used for signing edits. If the password is provided then HTTP basic authentication is used. Run the script with the -h parameter to see online help.
To experiment with this configuration, run the script and then visit http://127.0.0.1:8080 in a browser.
Changes made in the browser propagate to the server over HTTP (use the browser developer console to see these requests). The server then syncs changes to the file system (and logs each change to the screen).
test: build and run tests
This script runs the test edition of TiddlyWiki on the server to perform the server-side tests and to build test.html for running the tests in the browser.
lazy: serves tw5.com with lazily loaded images
./bin/lazy.sh <username> [<password>]Or:
./bin/lazy.cmd <username> [<password>]This script serves the tw5.com-server edition content with LazyLoading applied to images.
Introduction
The scrollable widget wraps its content in a scrollable frame. The user can scroll the contents with the mouse or with touch gestures. Code can use the WidgetMessage: tm-scroll to programmatically scroll specific DOM nodes into view.
Content and Attributes
The content of the <$scrollable> widget is displayed within a pair of wrapper DIVs. If the inner DIV is larger then it scrolls within the outer one. CSS is used to specify the size of the outer wrapper.
| Attribute | Description |
|---|---|
| class | The CSS class(es) to be applied to the outer DIV |
| fallthrough | See below |
If a scrollable widget can't handle the tm-scroll message because the inner DIV fits within the outer DIV, then by default the message falls through to the parent widget. Setting the fallthrough attribute to no prevents this behaviour.
Examples
This example requires the following CSS definitions from $:/_tw5.com-styles:
.tc-scrollable-demo {
border: 1px solid <<colour message-border>>;
background-color: <<colour message-background>>;
padding: 1em;
height: 400px;
position: relative;
}This wiki text shows how to display a list within the scrollable widget:
<$scrollable class='tc-scrollable-demo'>
<$list filter='[!is[system]]'>
<$view field='title'/>: <$list filter='[all[current]links[]sort[title]]' storyview='pop'>
<$link><$view field='title'/></$link>
</$list>
</$list>
</$scrollable>
Este es su aspecto:
AllTiddlers:
License: $:/core/copyright.txt ShadowTiddlers TiddlyWiki
TableOfContents:
About:
Acknowledgements: Community TiddlyWiki
Contributors:
Developers: TiddlyWiki
History of TiddlyWiki: ActiveX BT GTDTiddlyWiki JavaScript JeremyRuston LifeHacker Osmosoft SocialText TiddlySpace TiddlyWeb TiddlyWiki TiddlyWiki5 UnaMesa
Philosophy of Tiddlers: Structuring TiddlyWiki Tiddlers TiddlyWiki
BuildCommand: TiddlyWikiFolders
ClearPasswordCommand:
Commands: TiddlyWiki on Node.js
DeleteTiddlersCommand:
EditionsCommand:
FetchCommand:
HelpCommand:
ImportCommand:
InitCommand: Environment Variables on Node.js
ListenCommand: TiddlyWiki WebServer
LoadCommand:
MakeLibraryCommand: UpgradeMechanism
NamedCommandParameters: Commands TiddlyWiki
OutputCommand:
PasswordCommand:
RenderCommand:
RenderTiddlerCommand:
RenderTiddlersCommand:
SaveCommand:
SaveTiddlerCommand:
SaveTiddlersCommand:
SaveWikiFolderCommand:
ServerCommand: ListenCommand TiddlyWiki WebServer
SetFieldCommand:
UnpackPluginCommand:
VerboseCommand:
VersionCommand:
Articles:
Community: TiddlyWiki
Contributing: HelpingTiddlyWiki Improving TiddlyWiki Documentation ReportingBugs TiddlyWiki
Contributor License Agreement: TiddlyWiki TiddlyWiki5 UnaMesa
Examples:
Forums: http://groups.google.com/group/TiddlyWiki GitHub TiddlyDesktop TiddlyFox TiddlyWiki TiddlyWiki Hangouts
HelpingTiddlyWiki: Contributing GitHub OpenSource TiddlyWiki
Improving TiddlyWiki Documentation: Contributor License Agreement Documentation Style Guide TiddlyWiki
Latest:
Meetups: OXTWIG TiddlyWiki TiddlyWiki Camp Paris
OXTWIG: TiddlyWiki
ReportingBugs: Forums GitHub TiddlyWiki
Resources: Community
Signing the Contributor License Agreement: GitHub
TiddlyWiki Camp Paris: TiddlyWiki
TiddlyWiki Hangouts: TiddlyWiki
TiddlyWiki European Meetup 2016:
TiddlyWiki European Meetup 2017: TiddlyWiki
Translate TiddlyWiki into your language: GitHub TiddlyWiki
Tutorials:
"A free, open source wiki revisited" by Mark Gibbs, NetworkWorld: TiddlyWiki
"Notizen mit TiddlyWiki systemübergreifend nutzen" by Michael Sonntag: TiddlyWiki
"Setting Up a Personal TiddlyWiki Server on OS X" by Kris Johnson: TiddlyWiki TiddlyWiki on Node.js
"TiddlyWiki 5 im Betatest" by besim: JavaScript TiddlyWiki TiddlyWiki5 TiddlyWikiClassic
"TiddlyWiki" by Sander de Boer: JavaScript NoScript TiddlyWiki
"A Thesis Notebook" by Alberto Molina: TiddlyWiki
Interactive Git Documentation by Devin Weaver:
Obadiah TOC:
PESpot Lesson Planner by Patrick Detzner: TiddlyWiki
"PETTIL - Forth for the Commodore PET" by Charlie Hitselberger:
Simple Zork-like Game by Jed Carty: JavaScript TiddlyWiki
TriTarget.org by Devin Weaver: TiddlyWiki TriTarget
Ace Editor Plugin by Joerg Plewe: IndexedDb SyncAdaptor TiddlyWiki
"BJTools" by buggyj:
"BrainTest - tools for a digital brain" by Danielo Rodriguez:
Code styles and auto format settings for IDEs: TiddlyWiki
"CouchDB Adaptor" by William Shallum: CouchDB TiddlyWiki
Disqus comments plugin by bimlas:
"Encrypt single tiddler plugin" by Danielo Rodriguez:
Eucaly's Tiddly World: FieldFilter FlexWidth MatchFilter MonkeyTaggerMacro PopupTagger QuickJump TagBar TagTable TiddlyWiki TitleMe
"Filter Examples" by Tobias Beer: Filters ListWidget
"Font Awesome 5 Free SVGs for TiddlyWiki" by morosanuae:
Full Text Search Plugin by Rob Hoelz: TiddlyWiki
"GSD5" by Roma Hicks: TiddlyWiki TiddlyWiki5
"Gospel Bubbles" by Rev. David Gifford:
"Heeg.ru" by sini-Kit: TiddlyWiki
"Hosting TiddlyWiki5 on GoogleDrive" by Tony Ching: TiddlyWiki TiddlyWiki5
"How Does Twederation Work" by Jed Carty: TiddlyWiki
IndexedDB Plugin by Andreas Abeck: IndexedDB IndexedDb SyncAdaptor
Json Mangler plugin by Joshua Fontany:
Kin filter operator by bimlas:
Leaflet maps plugin by Sylvain Comte: Filters GeoTiddler TiddlyWiki
Locator plugin by bimlas:
MathJax Plugin by Martin Kantor: MathJax MathML TeX TiddlyWiki
Plugins by TheDiveO: FontAwesome TheDiveO TiddlyWiki
Plugins by Uwe Stuehler: TiddlyWiki
SeeAlso by Matias Goldman:
"TB5 - a pocket full of tips" by Tobias Beer: TiddlyWiki
"TW5 Magick" by Stephan Hradek: TiddlyWiki
TW5-SingleExecutable by Jed Carty: TiddlyWiki5
TWCommunitySearch: TiddlyWiki
TWaddle by Matias Goldman: Bigger community ⇄ Better TW TiddlyWiki
TiddlyChrome by Arlen Beiler: TiddlyWiki
TiddlyClip by buggyjay: BuggyJay Firefox TiddlyClip TiddlyWiki
TiddlyDrive Add-on for Google Drive by Joshua Stubbs: TiddlyWiki
TiddlyMap Plugin by Felix Küppers: GitHub TiddlyWiki
TiddlyServer by Arlen Beiler: NodeJS TiddlyServer TiddlyWiki TiddlyWikis
TiddlyWiki Jingle by Måns Mårtensson: TiddlyWiki
"TiddlyWiki Notes" by James Anderson: TiddlyWiki
"TiddlyWiki Posts" by Jeffrey Kishner: TiddlyWiki
TiddlyWiki Video Tutorials by Francis Meetze: TiddlyWiki
TiddlyWiki extensions for Sublime Text 3 by roma0104: TiddlyWiki5
TiddlyWiki extensions for ViM: TiddlyWiki5
"TiddlyWiki for Scholars" by Alberto Molina: TiddlyWiki
"TiddlyWiki guide FR" by Sylvain Naudin: TiddlyWiki
"TiddlyWiki 舞" by Bram Chen: TiddlyWiki
"TiddlyWiki5 Coding" by Chris Hunt: TiddlyWiki TiddlyWiki5
"TiddlyWiki5 Playground" by Ton Gerner: TiddlyWiki
"TiddlyWiki5^2 documenting while learning TiddlyWiki5" by Iannis Zannos: TiddlyWiki TiddlyWiki on Node.js TiddlyWiki5
Tinka by Andreas Hahn: GitHub
Widdly by Opennota: TiddlyWiki
"Wikilabs" by PMario:
"Wills Q&D gTD" by Matabele: TiddlyWiki
"ATWiki" by Lamusia Project: TiddlyWiki
"Cardo - Task and Project Management Wiki" by David Szego:
"Dropboard" by Reid Gould: TiddlyWiki
"Dynamic Tables" by Jed Carty:
"Ghostwriter theme by Rory Gibson" adapted for TW5 by Riz:
"Hacks" by Thomas Elmiger:
"In My Socks" by Jed Carty:
"JD Mobile Layout plugin" by JD: TiddlyWiki
"Lucky Sushi" online shop by sini-Kit:
"Mal's Sandbox" by Mal: $:/core/modules/commands/load.js $:/plugins/malgam/loadnew/loadnew.js JavaScript
"MathCell" by Stephen Kimmel: TiddlyWiki
"Moments: A little color won't hurt" by Riz:
"Noteself" by Danielo Rodríguez:
"SK Plugins" by Stephen Kimmel: TiddlyWiki
"Slides and Stories" by Jan:
"TW5-TeXZilla" plugin by Joe Renes: KaTeX Plugin LaTeX MathJax MathML TiddlyWiki5
"TWeb.at" by Mario Pietsch: TiddlyWeb TiddlyWiki
"Tekan: Kanban that stays with you" by Riz: TiddlyWiki
"TiddlyServer" by Matt Lauber: TiddlyFolder TiddlyServer TiddlyWiki
"TiddlyWiki Knowledge Network" by Dmitry Sokolov:
"TiddlyWiki Toolmap" by David Gifford: TiddlyWiki TiddlyWikis
"TiddlyWiki5 Bourbon" by mkt_memory: TiddlyWiki TiddlyWiki5
"TiddlyWiki5 Forum on Reddit" by Riz: TiddlyWiki5
"Timimi" Extension and executable by Riz:
"X3DOM for TiddlyWiki 5" by Jamal Wills: JavaScript TiddlyWiki
"file-backups" Extension for Firefox by pmario: Saving with the HTML5 fallback saver
"muritest" by Simon Huber: Plugins by Uwe Stuehler
"savetiddlers" Extension for Chrome and Firefox by buggyj: Saving with the HTML5 fallback saver TiddlyFox TiddlyWiki
datepicker plugin based on Pikaday, by kixam: EditTextWidget TiddlyWiki
rboue's plugins for TiddlyWiki: TiddlyWiki
twproxy by Steve Gattuso: TiddlyWiki
vis.js Timeline by emkay, revived by kixam: TiddlyWiki
"Creating a baby journal with TiddlyWiki 5" from A Penguin in Redmond: TiddlyWiki
"Install and run TiddlyWiki on a CentOS 6 VPS using Nginx" from RoseHosting: TiddlyWiki
"Microblogging con Tiddlywiki" by Juan: TiddlyWiki
"デザイン刷新。次の25年を目指すTiddlyWiki" by Moongift: TiddlyWiki
"Shining Ark Using TiddlyWiki" by Helu: TiddlyWiki
"TW5 Tribal Knowledge" from Scott Kingery: TiddlyWiki
"Un wiki sur votre BiblioBox avec TiddlyWiki" from A Penguin in Redmond: BiblioBox TiddlyWiki
ColourPalettes: CSS DataTiddlers
Concepts:
Current Tiddler: storyTiddler Variable TemplateTiddlers WikiText
DataTiddlers: DictionaryTiddlers JSONTiddlers TextReference
Date Fields: DateFormat TiddlerFields
DefaultTiddlers: $:/ControlPanel $:/DefaultTiddlers Filter Expression PermaLinks Story River
DictionaryTiddlers: ColourPalettes ContentType DataTiddlers
Dominant Append: Filters Title Selection
ExternalImages: $:/core/templates/canonical-uri-external-image WikiFolders
Filters: $:/AdvancedSearch CountWidget Filter Operators Filter Syntax Introduction to filter notation ListWidget Title Selection
Hard and Soft Links: Macros Transclusion Variables WikiText
InfoPanel: GitHub InfoPanel ShadowTiddlers TiddlerFields TiddlyWiki Using links to navigate between tiddlers
JSONTiddlers: $:/HistoryList ContentType DataTiddlers JavaScript Object Notation
Keyboard Shortcut Tiddler: $:/ControlPanel Keyboard Shortcut Descriptor KeyboardShortcuts
Macros: Core Macros Linking in WikiText Macros in WikiText Pragma Transclusion Transclusion and Substitution Variables Widgets WikiText
Messages:
ModuleType: Modules
Modules: $:/ControlPanel JavaScript ModuleType TiddlyWiki5
Order of Tagged Tiddlers: TagTiddlers Title List
PermaLinks: Filters StoryRiver
Railroad Diagrams: Railroad Plugin
Selection Constructors: Filter Operators Filter Step Title Selection
ShadowTiddlers: Plugins ShadowTiddlers
Story River: Tiddlers
SystemTags:
SystemTiddlers: TiddlyWiki
TagTiddlers: InfoPanel
TemplateTiddlers: Current Tiddler TiddlyWiki Transclusion Transclusion with Templates ViewTemplate WikiText
TextReference: Current Tiddler DataTiddlers Filter Parameter Filters HTML in WikiText LinkCatcherWidget RevealWidget TextReference TiddlerFields
TiddlerFields: $:/ControlPanel BagField CaptionField ClassField ColorField CreatedField CreatorField DescriptionField DraftOfField DraftTitleField FooterField HideBodyField IconField LibraryField ListAfterField ListBeforeField ListField ModifiedField ModifierField NameField PluginPriorityField PluginTypeField RevisionField SourceField SubtitleField TagsField TextField Tiddlers TiddlyWebAdaptor TitleField TocLink TypeField
TiddlerLinks: $:/core/copyright.txt $:/SiteTitle ATiddlerThatDoesntExist Filters InfoPanel StoryView TiddlerLinks TiddlyWiki5
Tiddlers: JavaScript TiddlerFields TiddlyWiki
TiddlyWiki: Community JeremyRuston ListField Macros OpenSource Philosophy of Tiddlers Structuring TiddlyWiki Tagging TiddlerLinks Tiddlers WikiText
TiddlyWiki5: JavaScript Node.js TiddlyWiki TiddlyWiki5
TiddlyWikiFolders: BuildCommand Customizing Tiddler File Naming PluginMechanism TiddlyWiki on Node.js
Title List: Filters ListField PermaLinks Title Selection
Title Selection: Filters Title List
Transclusion: Philosophy of Tiddlers TemplateTiddlers TextReference TranscludeWidget Transclusion and Substitution Transclusion Basic Usage Transclusion in WikiText Transclusion with Templates
Wiki: WikiStore
WikiText: Editor toolbar Formatting text in TiddlyWiki WikiText
Configuring startup tiddlers: DefaultTiddlers Filter Expression Preserving open tiddlers at startup
Customise TiddlyWiki:
Customising search results:
Page and tiddler layout customisation: ImportTiddlers SystemTags
BT: JeremyRuston Osmosoft
Base64:
CamelCase:
Cascading Style Sheets:
Comma-Separated Values:
ContentType: Cascading Style Sheets Comma-Separated Values TiddlyWiki
Data URI: Cascading Style Sheets
Definitions: Concepts TiddlyWiki
Document Object Model: TiddlyWiki on Node.js Widgets
Federatial: JeremyRuston TiddlyWiki
GitHub: GitHub Saving to GitHub TiddlyWiki
GuerillaWiki: GuerillaWiki TiddlyWiki
HyperText Markup Language: WikiText
JavaScript Object Notation: DataTiddlers
JavaScript:
JeremyRuston: Federatial TiddlyWiki
Jermolene: JeremyRuston
Keyboard Shortcut Descriptor: KeyboardWidget
MathML: WikiText
NW.js: Node.js OpenSource TiddlyWiki TiddlyWiki on NW.js
Node.js: JavaScript TiddlyWiki on Node.js
OpenSource: OpenSource
Osmosoft: BT JeremyRuston TiddlyWiki
Percent Encoding: URI
Quine:
SingleFileApplication: Quine SinglePageApplication
SinglePageApplication: SingleFileApplication TiddlyWiki
Stanford JavaScript Crypto Library:
TiddlyDesktop: GitHub Introducing TiddlyDesktop Video NW.js OpenSource TiddlyDesktop TiddlyDesktop Releases TiddlyWiki TiddlyWiki5 TiddlyWikiClassic
TiddlyFox: Firefox Firefox Apocalypse GettingStarted GitHub Saving with TiddlyFox Saving with TiddlyFox on Android TiddlyFox TiddlyWiki
TiddlyIE: Saving with TiddlyIE TiddlyIE TiddlyWiki
TiddlySpace: BT Osmosoft TiddlySpace TiddlyWeb
TiddlyWeb: Tiddlers TiddlySpace TiddlyWeb TiddlyWiki5
TiddlyWikiClassic: TiddlyWiki TiddlyWiki5 TiddlyWikiClassic
URI:
node-webkit: NW.js
Alice in Wonderland:
Apple:
Caruso - Ave Maria:
GroupedLists: $:/core/ui/MoreSideBar/Types $:/core/ui/SideBar/Recent
ImageGallery Example: $:/tags/Image ListWidget TranscludeWidget
SampleAlert: SampleAlert
SampleNotification:
SampleTabFour:
SampleTabOne:
SampleTabThree:
SampleTabTwo:
SampleTiddlerFirst: SampleTiddlerFirst
SampleTiddlerSecond: SampleTiddlerSecond
SampleTiddlerThird: SampleTiddlerThird
SampleWizard: SampleWizard
SampleWizard2: SampleWizard2
TabbedExampleType:
Contents:
First:
FirstOne:
FirstThree:
FirstTwo:
Fourth:
Second:
SecondOne:
SecondThree:
SecondThreeOne:
SecondThreeThree:
SecondThreeTwo:
SecondTwo:
Third:
ThirdOne:
ThirdThree:
ThirdTwo:
Example Table of Contents: Expandable:
Example Table of Contents: Selectively Expandable:
Example Table of Contents: Simple:
Example Table of Contents: Sorted Expandable:
Example Table of Contents: Tabbed Internal:
Example Table of Contents: Tabbed External:
Example for tag Macro:
Compose ballad: TaskManagementExample
Get the Ring: TaskManagementExample
Go to Mordor: TaskManagementExample
Kill the Dragon: TaskManagementExample
Make the beds: TaskManagementExample
TaskManagementExample: TiddlyWiki5
TaskManagementExample (Draggable): TaskManagementDemo
TaskManagementExampleDraggableTemplate:
done:
task: TaskManagementExample
TiddlyWiki.mp3:
Days of the Week:
Friday:
Monday:
Saturday:
Sunday:
Thursday:
Tuesday:
Wednesday:
sampletag1:
sampletag2:
Blog Edition:
Editions: TiddlyWiki
Empty Edition: TiddlyWiki
Full Edition:
Résumé Builder Edition:
Text-Slicer Edition:
XLSX Utilities Edition: TiddlyWiki
AutoSave: SaverModule
DateFormat: ViewWidget
Drag and Drop: $:/ControlPanel DragAndDropMechanism Importing Tiddlers list-links-draggable Macro list-tagged-draggable Macro ListField Mobile Drag And Drop Shim Plugin
Features: Quine
Future Proof: OpenSource
Importing Tiddlers: Drag and Drop How to export tiddlers TiddlyWiki
LazyLoading: TiddlyWeb TiddlyWiki in the Sky for TiddlyWeb TiddlyWiki on Node.js
Modals: WidgetMessage: tm-modal
Notifications:
Performance Instrumentation: JavaScript
SafeMode: Upgrading
Scalability: SinglePageApplication
Searching in TiddlyWiki: $:/AdvancedSearch Filters ShadowTiddlers SystemTiddlers
StartupActions: ActionWidgets Pragma TiddlyWiki
ListField: Filters NavigatorWidget StoryList Tagging TiddlerFields Title List
MultiTiddlerFileSyntax: MultiTiddlerFiles
MultiTiddlerFiles: $:/language/ControlPanel/Basics/Caption $:/language/ControlPanel/Basics/Version MultiTiddlerFiles
TiddlerFiles: ContentType TiddlyWiki
Conditional Operators: else Operator get Operator then Operator
Filter Operators: all Operator Filter Parameter Filter Run Filter Step Filter Syntax Filters Selection Constructors Title Selection
Introduction to filter notation: TextReference Variables
Mathematics Operators:
abs Operator: Mathematics Operators
add Operator: Mathematics Operators
addprefix Operator:
addsuffix Operator:
after Operator:
all Operator: Current Tiddler Dominant Append Filter Parameter Hard and Soft Links ShadowTiddlers
allafter Operator:
allbefore Operator:
append Operator:
backlinks Operator: Dominant Append
before Operator:
bf Operator:
butfirst Operator:
butlast Operator:
ceil Operator: Mathematics Operators
commands Operator:
contains Operator:
count Operator:
days Operator:
decodehtml Operator:
decodeuri Operator:
decodeuricomponent Operator:
divide Operator: Mathematics Operators
each Operator: Title List
eachday Operator:
editiondescription Operator:
editions Operator:
else Operator: Conditional Operators
encodehtml Operator:
encodeuri Operator:
encodeuricomponent Operator:
enlist Operator:
escapecss Operator:
escaperegexp Operator:
abs Operator (Examples):
add Operator (Examples):
addprefix Operator (Examples):
addsuffix Operator (Examples):
after Operator (Examples): Thursday
all Operator (Examples):
allafter Operator (Examples):
allbefore Operator (Examples):
append Operator (Examples):
backlinks Operator (Examples):
before Operator (Examples): Thursday
butlast Operator (Examples):
ceil Operator (Examples):
commands Operator (Examples):
contains Operator (Examples):
count Operator (Examples):
days Operator (Examples):
decodehtml Operator (Examples):
decodeuri Operator (Examples):
decodeuricomponent Operator (Examples):
divide Operator (Examples):
each Operator (Examples): GroupedLists
eachday Operator (Examples): GroupedLists
else Operator (Examples):
encodehtml Operator (Examples):
encodeuri Operator (Examples):
encodeuricomponent Operator (Examples):
enlist Operator (Examples):
escapecss Operator (Examples):
escaperegexp Operator (Examples):
exponential Operator (Examples):
field Operator (Examples):
fields Operator (Examples):
first Operator (Examples):
fixed Operator (Examples):
floor Operator (Examples):
get Operator (Examples):
getindex Operator (Examples):
getvariable Operator (Examples):
has Operator (Examples):
indexes Operator (Examples):
is Operator (Examples):
join Operator (Examples):
jsonstringify Operator (Examples):
last Operator (Examples):
length Operator (Examples):
limit Operator (Examples):
links Operator (Examples): Filter Operators HelloThere links Operator
list Operator (Examples):
listed Operator (Examples):
lookup Operator (Examples):
lowercase Operator (Examples):
match Operator (Examples):
max Operator (Examples):
maxall Operator (Examples):
min Operator (Examples):
minall Operator (Examples):
minlength Operator (Examples):
modules Operator (Examples):
moduletypes Operator (Examples):
move Operator (Examples):
multiply Operator (Examples):
negate Operator (Examples):
next Operator (Examples):
nsort Operator (Examples):
nsortcs Operator (Examples):
nth Operator (Examples):
plugintiddlers Operator (Examples):
precision Operator (Examples):
prefix Operator (Examples):
prepend Operator (Examples):
previous Operator (Examples):
product Operator (Examples):
putafter Operator (Examples):
putbefore Operator (Examples):
putfirst Operator (Examples):
putlast Operator (Examples):
regexp Operator (Examples): Variables
remainder Operator (Examples):
remove Operator (Examples):
removeprefix Operator (Examples):
removesuffix Operator (Examples):
replace Operator (Examples):
rest Operator (Examples):
reverse Operator (Examples):
round Operator (Examples):
sameday Operator (Examples):
search Operator (Examples):
sentencecase Operator (Examples):
shadowsource Operator (Examples):
sign Operator (Examples):
sort Operator (Examples):
sortan Operator (Examples): Apple
sortby Operator (Examples):
sortcs Operator (Examples):
split Operator (Examples):
splitbefore Operator (Examples):
splitregexp Operator (Examples):
storyviews Operator (Examples):
stringify Operator (Examples):
subfilter Operator (Examples):
subtiddlerfields Operator (Examples):
subtract Operator (Examples):
suffix Operator (Examples):
sum Operator (Examples):
tag Operator (Examples):
tagging Operator (Examples):
tags Operator (Examples):
then Operator (Examples):
title Operator (Examples):
titlecase Operator (Examples):
trim Operator (Examples):
trunc Operator (Examples):
untagged Operator (Examples):
untrunc Operator (Examples):
uppercase Operator (Examples):
variables Operator (Examples):
exponential Operator: Mathematics Operators
field Operator: Filter Operators Filter Step
fields Operator: Dominant Append
first Operator:
fixed Operator: Mathematics Operators
floor Operator: Mathematics Operators
get Operator: Filter Operators Title Selection
getindex Operator: DataTiddlers Dominant Append
getvariable Operator:
has Operator:
haschanged Operator:
indexes Operator: DataTiddlers Dominant Append JSONTiddlers
insertbefore Operator:
is Operator: ContentType Current Tiddler Filter Expression Filter Run Hard and Soft Links ShadowTiddlers SystemTiddlers
join Operator:
jsonstringify Operator: stringify Operator
last Operator:
length Operator:
limit Operator:
links Operator: Dominant Append
list Operator: Current Tiddler TextReference
listed Operator: Dominant Append Title List
lookup Operator:
lowercase Operator: sentencecase Operator uppercase Operator
match Operator:
max Operator: Mathematics Operators maxall Operator min Operator minall Operator
maxall Operator: Mathematics Operators max Operator min Operator minall Operator
min Operator: Mathematics Operators max Operator maxall Operator minall Operator
minall Operator: Mathematics Operators max Operator maxall Operator min Operator
minlength Operator:
modules Operator:
moduletypes Operator:
move Operator:
multiply Operator: Mathematics Operators product Operator
negate Operator: Mathematics Operators
next Operator:
nsort Operator:
nsortcs Operator:
nth Operator:
order Operator:
plugintiddlers Operator:
precision Operator: exponential Operator fixed Operator Mathematics Operators
prefix Operator:
prepend Operator:
previous Operator:
product Operator: Mathematics Operators multiply Operator
putafter Operator:
putbefore Operator:
putfirst Operator:
putlast Operator:
range Operator: Formula Plugin
regexp Operator: Filter Run Variables
remainder Operator: Mathematics Operators
remove Operator:
removeprefix Operator:
removesuffix Operator:
replace Operator:
rest Operator:
reverse Operator:
round Operator: Mathematics Operators
sameday Operator:
search Operator:
sentencecase Operator: lowercase Operator titlecase Operator uppercase Operator
shadowsource Operator: Dominant Append
sign Operator: Mathematics Operators
sort Operator:
sortan Operator:
sortby Operator:
sortcs Operator:
split Operator: is Operator join Operator split Operator splitregexp Operator
splitbefore Operator: Dominant Append Table-of-Contents Macros
splitregexp Operator: is Operator join Operator split Operator splitregexp Operator
storyviews Operator: Modules
stringify Operator: jsonstringify Operator
subfilter Operator:
subtiddlerfields Operator:
subtract Operator: Mathematics Operators
suffix Operator:
sum Operator: Mathematics Operators
Filter Expression: Dominant Append Filter Run Filter Syntax ShadowTiddlers
Filter Parameter: DataTiddlers Filter Operators TextReference TiddlerFields Variables
Filter Run: Filter Expression Filter Step Title Selection
Filter Step: Filter Expression Filter Operators Filter Run Filter Syntax TiddlerFields Title Selection
Filter Syntax: Filter Expression Filter Run Filter Step Title Selection
Filter Whitespace: Filter Expression Filter Run
tag Operator: Order of Tagged Tiddlers
tagging Operator: Dominant Append Order of Tagged Tiddlers
tags Operator: Dominant Append
then Operator: Conditional Operators
title Operator: Selection Constructors
titlecase Operator: lowercase Operator sentencecase Operator uppercase Operator
trim Operator:
trunc Operator: Mathematics Operators
untagged Operator:
untrunc Operator: Mathematics Operators
uppercase Operator: lowercase Operator sentencecase Operator
variables Operator: dumpvariables Macro
GettingStarted - Android: AndTidWiki TiddlyFox TiddlyWiki
GettingStarted - Chrome: TiddlyWiki
GettingStarted - Firefox: TiddlyFox TiddlyWIki
GettingStarted - Internet Explorer: Windows HTA Hack TiddlyWiki
GettingStarted - Node.js:
GettingStarted - Online: CouchDB TiddlyWiki
GettingStarted - Safari: TiddlyWiki
GettingStarted - iOS:
GettingStarted: A Gentle Guide to TiddlyWiki Encryption Saving on TiddlySpot TiddlyDesktop TiddlyWiki
A Gentle Guide to TiddlyWiki: Creating and editing tiddlers GettingStarted Philosophy of Tiddlers Sharing your tiddlers with others StoryLists Structuring TiddlyWiki TableOfContents TiddlyWiki TiddlyWiki on Node.js TiddlyWiki Video Tutorials by Francis Meetze
Discover TiddlyWiki: Community Philosophy of Tiddlers TagPills
HelloThere: "TiddlyWiki for Scholars" by Alberto Molina Creating and editing tiddlers Philosophy of Tiddlers Sharing your tiddlers with others Structuring TiddlyWiki TaskManagementExample TiddlyWiki
HelloThumbnail:
Some of the things you can do with TiddlyWiki: https://tiddlywiki.com/plugins/tiddlywiki/d3/ ImageGallery Example Motovun Jack.jpg SampleWizard TaskManagementExample
Ten reasons to switch to TiddlyWiki:
What happened to the original TiddlyWiki?: TiddlyWiki TiddlyWiki5 TiddlyWikiClassic WikiText
HelloThumbnail - Classic:
HelloThumbnail - Developers:
HelloThumbnail - Gentle Guide:
HelloThumbnail - HelpingTiddlyWiki:
HelloThumbnail - Introduction Video:
HelloThumbnail - Latest Version:
HelloThumbnail - TWEUM2017:
HelloThumbnail - TiddlyMap:
Hidden Setting: Tab Index for Edit-Inputs: $:/config/EditTabIndex
Hidden Setting: New-Image Type: $:/config/NewImageType
Hidden Setting: Filename for Save Wiki Button: $:/config/SaveWikiButton/Filename $:/ControlPanel $:/SiteTitle
Hidden Setting: Template for Save Wiki Button: $:/config/SaveWikiButton/Template
Hidden Setting: Search Minimum Length: $:/config/Search/MinLength
Hidden Setting: Sync Polling Interval: $:/config/SyncPollingInterval
Hidden Setting: Tags Minimum Length: $:/config/Tags/MinLength
Hidden Setting: ViewTemplate and EditTemplate: $:/config/ui/EditTemplate $:/config/ui/ViewTemplate $:/core/ui/PageTemplate/story
Hidden Setting: Scroll Top Adjustment: TiddlyWiki
Hidden Setting: Search AutoFocus: $:/config/Search/AutoFocus TiddlyWiki
Hidden Setting: Typing Refresh Delay: $:/config/Drafts/TypingTimeout TiddlyWiki
Hidden Settings: TiddlyWiki
Adding a Twitter Follow button: TiddlyWiki
Adding a table of contents to the sidebar: Macros Table-of-Contents Macros TableOfContents Tagging
Adopt a Titles Policy: Documentation Style Guide TiddlyWiki
Concatenating text and variables using macro substitution: MacroCallWidget
Configuring the default TiddlerInfo tab: $:/config/TiddlerInfo/Default InfoPanel
Creating SubStories: HelloThere
Creating a custom export format:
Creating a splash screen: $:/SplashScreen $:/tags/RawMarkupWikified/TopBody SystemTag: $:/tags/RawMarkupWikified/TopBody TiddlyWiki WikiText
Custom styles by data-tiddler-title: Custom data-styles
Custom styles by user-class: $:/core/ui/ViewTemplate $:/TagManager How to apply custom styles
Attribute Selectors:
Custom Styles FAQ:
Custom data-styles: DejaVu
Custom styles by data-tags: Custom data-styles Hard Linebreaks with CSS
Editing Tiddlers with Emacs: TiddlyWiki
Editing Tiddlers with Vim: TiddlyWiki
Editor toolbar: Markdown Plugin WikiText
Formatting List Results as Tables with CSS - Specified Columns Methods: Formatting List Results as Tables (no CSS) Formatting List Results as Tables with CSS - Variable Column Method
Formatting List Results as Tables with CSS - Variable Column Method: Formatting List Results as Tables (no CSS) Formatting List Results as Tables with CSS - Specified Columns Methods
Formatting List Results as Tables (no CSS): Formatting List Results as Tables with CSS - Specified Columns Methods Formatting List Results as Tables with CSS - Variable Column Method nth Operator
Generating Static Sites with TiddlyWiki: DefaultTiddlers JavaScript RenderTiddlerCommand RenderTiddlersCommand TiddlyWiki TiddlyWiki5
Hard Linebreaks with CSS: Custom data-styles Hard Linebreaks with CSS - Example How to apply custom styles TiddlyWiki
Hard Linebreaks with CSS - Example: WikiText
Height of text editor:
How to add a banner for GitHub contributions: $:/ContributionBanner GitHub Improving TiddlyWiki Documentation
How to apply custom styles by tag: Using Stylesheets
How to apply custom styles:
How to build a TiddlyWiki5 from individual tiddlers: Installing TiddlyWiki on Node.js TiddlerFiles TiddlyWiki TiddlyWiki5 TiddlyWikiFolders
How to change the sort order of sub-branches in a TOC macro: Table-of-Contents Macros
How to create keyboard shortcuts: $:/config/shortcuts- $:/config/shortcuts-linux/ $:/config/shortcuts-mac/ $:/config/shortcuts-not-linux/ $:/config/shortcuts-not-mac/ $:/config/shortcuts-not-windows/ $:/config/shortcuts-windows/ $:/config/shortcuts/ $:/ControlPanel $:/core/ui/ControlPanel/KeyboardShortcuts $:/core/ui/PageMacros $:/tags/Macro ActionNavigateWidget Key Descriptor Keyboard Shortcut Descriptor KeyboardWidget my-macro-tiddler
How to Customize TiddlyDesktop: HelloThere TiddlyDesktop TiddlyWiki
How to embed PDF and other documents: ContentType ExternalImages node.js
How to export tiddlers: $:/AdvancedSearch Filters
How to hide the author's and other fields with CSS:
How to put the last modification date in a banner: $:/_MyRibbon $:/tags/PageControls $:/tags/PageTemplate Installing a plugin from the plugin library
How to widen tiddlers (aka storyriver):
How to add a new tab to the sidebar: $:/core/ui/SideBar/Open $:/tags/SideBar SystemTags Table-of-Contents Macros TableOfContents Tagging
How to turn off camel case linking: $:/ControlPanel CamelCase
Insert link: Insert picture WikiText
Insert picture: WikiText
KeyboardShortcuts:
Making a custom journal button: $:/core/ui/Buttons/new-journal
Making curved text with SVG:
More actions:
Preserving open tiddlers at startup:
Setting a favicon: $:/favicon.ico ServerCommand
Setting a page background image: ControlPanel ExternalImages Images in WikiText
Sharing a TiddlyWiki on Dropbox: TiddlyWiki
Simple ways to write protect tiddlers:
Structuring TiddlyWiki: DataTiddlers Tagging TiddlerLinks Tiddlers TiddlyWiki5 Title List
Tagging: $:/TagManager Creating and editing tiddlers Filters InfoPanel Order of Tagged Tiddlers Page and tiddler layout customisation TiddlerFields Title List
Text preview:
The First Rule of Using TiddlyWiki: TiddlyFox TiddlyWiki
Upgrading: SafeMode TiddlyWiki
Using Excise: EditorToolbar Linking in WikiText Macros Transclusion
Using SVG: $:/SVGExampleRadius HelloThere Motovun Jack.svg Tiddler Fishes.svg TiddlyWiki5 Typed Blocks in WikiText WikiText
Using Stamp:
Using Stylesheets: ColourPalettes RevealWidget Stylesheet Macros WikiText
Using TiddlyWiki for GitHub project documentation: GitHub LinkWidget MarkDown ReadMe TiddlyWiki5 TiddlyWikiFolders
Using a custom path prefix with the client-server edition: ServerCommand TiddlyWiki on Node.js
Windows HTA Hack: TiddlyWiki
Q: Is there a way to create dynamic stylesheets?: Q: How can I use a custom field to style a tiddler?
Q: How can I use a custom field to style a tiddler?: Attribute Selectors
Q: What if a tiddler has no tags?: Attribute Selectors
Q: How can I style a tiddler if it has "this" AND "that" tag?: Attribute Selectors
Q: How can I style a tiddler if it has "this" OR "that" tag?: Attribute Selectors
Blurry Lawn.jpg:
Dev Thumbnail.jpg:
Introduction Video Thumbnail.jpg:
Motovun Jack.ascii:
Motovun Jack.jpg:
Motovun Jack.pdf:
Motovun Jack.svg:
New Release Banner:
Newnham Horizon.jpg:
PerlinLight.jpg:
Pinstripe.gif:
TWEUM Thumbnail.jpg:
Tiddler Fishes.svg:
Tiddler Poster.png:
TiddlyFox Apocalypse.png:
TiddlyMap.png:
TiddlyWiki Classic.png:
Language Icon: ca-ES:
Language Icon: cs-CZ:
Language Icon: da-DK:
Language Icon: de-AT:
Language Icon: de-DE:
Language Icon: el-GR:
Language Icon: en-US:
Language Icon: es-ES:
Language Icon: fr-FR:
Language Icon: hi-IN:
Language Icon: ia-IA:
Language Icon: it-IT:
Language Icon: ja-JP:
Language Icon: ko-KR:
Language Icon: nl-NL:
Language Icon: pa-IN:
Language Icon: pt-PT:
Language Icon: ru-RU:
Language Icon: sk-SK:
Language Icon: sv-SE:
Language Icon: zh-Hans:
Language Icon: zh-Hant:
Edición en Castellano:
Chinese (Simplified) Edition: Chinese (Traditional) Edition TiddlyWiki
Chinese (Traditional) Edition: Chinese (Simplified) Edition TiddlyWiki
Édition en Français (France): TiddlyWiki
Deutsch (Österreich) Edition: Deutsch (Deutschland) Edition TiddlyWiki
Deutsch (Deutschland) Edition: Deutsch (Österreich) Edition TiddlyWiki
Korean (Korea Republic) Edition:
LanguageGallery Example: ListWidget Tagging TranscludeWidget
Languages: Translate TiddlyWiki into your language
Copying tiddlers between TiddlyWiki files: TiddlyWiki
Introduction to Lists: Filter Operators Filters HelloThere list Operator list-links Macro listed Operator ListField Lists in WikiText ListWidget Order of Tagged Tiddlers The Extended Listops Filters TiddlerFields TiddlyWiki Transclusion with Templates WikiText
Learning: Reference TiddlyWiki WikiText
changecount Macro: Current Tiddler Macros
colour Macro: $:/palettes/Vanilla Cascading Style Sheets ColourPalettes Macros
contrastcolour Macro: $:/core/ui/TagTemplate Cascading Style Sheets Macros
Core Macros: Macros
csvtiddlers Macro: $:/core/templates/exporters/CsvFile Comma-Separated Values Filters Macros Title Selection
datauri Macro: Base64 Cascading Style Sheets Data URI Macros
dumpvariables Macro: Macros Variables Widgets
jsontiddlers Macro: $:/core/templates/exporters/JsonFile Filters JavaScript Object Notation Macros Title Selection
lingo Macro: Macros
list-links Macro: all Operator Cascading Style Sheets Filter Run Filter Step Filters Macros ShadowTiddlers Title Selection
makedatauri Macro: ContentType Data URI Macros
now Macro: DateFormat Macros
qualify Macro: Macros StateMechanism Widgets
resolvepath Macro: Macros
Stylesheet Macros: $:/core/macros/CSS Cascading Style Sheets Macros
Table-of-Contents Macros: Filter Expression Filter Step How to add a new tab to the sidebar Order of Tagged Tiddlers SecondThree StateMechanism SystemTiddlers Table-of-Contents Macros (Examples) Tagging TemplateTiddlers
tabs Macro: Cascading Style Sheets Filters Macros StateMechanism SystemTiddlers TemplateTiddlers Title Selection
tag Macro: Current Tiddler Macros
timeline Macro: Date Fields DateFormat Filter Expression Filter Step Macros
unusedtitle Macro: Macros
version Macro: Macros
colour-picker Macro: Macros
copy-to-clipboard Macro: Macros
Macro Calls in WikiText (Examples):
changecount Macro (Examples): New Tiddler
colour-picker Macro (Example 1):
colour-picker Macro (Examples):
colour Macro (Examples):
copy-to-clipboard Macro (Examples):
datauri Macro (Examples): WikiText
dumpvariables Macro (Examples):
image-picker Macro (Example 1):
image-picker Macro (Example 2):
image-picker Macro (Examples):
lingo Macro (Examples): DateFormat
list-links-draggable Macro (Examples):
list-links Macro (Examples):
list-tagged-draggable Macro (Examples):
makedatauri Macro (Examples):
now Macro (Examples):
qualify Macro (Examples): $:/editions/tw5.com/macro-examples/qualify-transcluded
resolvepath Macro (Examples):
tabs Macro (Examples):
tag Macro (Examples):
thumbnail Macro (Examples):
timeline Macro (Examples):
Table-of-Contents Macros (Examples): Table-of-Contents Macros TableOfContents
tree Macro (Examples):
tree-macro-example-house: tree Macro (Examples)
tree-macro-example-house-kitchen: tree Macro (Examples)
tree-macro-example-house-kitchen-table: tree Macro (Examples)
tree-macro-example-house-kitchen-sink: tree Macro (Examples)
tree-macro-example-house-kitchen-window: tree Macro (Examples)
tree-macro-example-house-attic: tree Macro (Examples)
tree-macro-example-house-attic-window: tree Macro (Examples)
tree-macro-example-house-attic-roof: tree Macro (Examples)
tree-macro-example-house-garden: tree Macro (Examples)
tree-macro-example-house-garden-shed: tree Macro (Examples)
tree-macro-example-house-garden-lawn: tree Macro (Examples)
tree-macro-example-car: tree Macro (Examples)
tree-macro-example-car-boot: tree Macro (Examples)
tree-macro-example-car-boot-lock: tree Macro (Examples)
tree-macro-example-car-boot-handle: tree Macro (Examples)
tree-macro-example-car-roof: tree Macro (Examples)
tree-macro-example-car-roof-rails: tree Macro (Examples)
tree-macro-example-car-roof-aerial: tree Macro (Examples)
unusedtitle Macro (Examples):
version Macro (Examples):
image-picker Macro: Filter Expression Filter Step Macros
jsontiddler Macro: JavaScript Object Notation Macros
list-links-draggable Macro: currentTiddler Variable Drag and Drop ListField Macros
list-tagged-draggable Macro: currentTiddler Variable Drag and Drop Macros Order of Tagged Tiddlers
Macro Call Syntax: Filter Whitespace Macros
Macro Definition Syntax: Filter Whitespace Macros
Macro Syntax:
tag-picker Macro: Macros
tag-pill Macro: Macros tag Macro
thumbnail Macro: Macros
tree Macro: Macros
AlertMechanism: $:/tags/Alert
DraftMechanism: ListWidget NavigatorWidget
DragAndDropMechanism: ButtonWidget Drag and Drop DraggableWidget DroppableWidget DropzoneWidget LinkWidget
HistoryMechanism: $:/config/EmptyStoryMessage $:/HistoryList GettingStarted
InfoMechanism: $:/info/browser $:/info/browser/language $:/info/browser/screen/height $:/info/browser/screen/width $:/info/node $:/info/url/full $:/info/url/host $:/info/url/hostname $:/info/url/origin $:/info/url/pathname $:/info/url/port $:/info/url/protocol $:/info/url/search Node.js WikiText
Mechanisms: TiddlyWiki
PluginMechanism: Installing a plugin from the plugin library JavaScript Modules PluginFolders Plugins ShadowTiddlers ThemeMechanism TiddlyWiki TiddlyWiki on Node.js TiddlyWiki5
PopupMechanism: ButtonWidget RevealWidget StateMechanism
SavingMechanism: $:/config/SaverFilter $:/core/save/all $:/plugins/tiddlywiki/tiddlyweb $:/plugins/tiddlywiki/tiddlyweb/save/offline ButtonWidget SavingMechanism TiddlyWiki WidgetMessage: tm-save-wiki
StateMechanism: $:/core/ui/PageTemplate $:/InfoPanelState $:/StoryList DraftMechanism NavigationMechanism StateMechanism StateTiddler TiddlyWiki WikiText
TranslationMechanism: $:/language $:/language/Docs/ModuleTypes/isfilteroperator $:/language/EditTemplate/Fields/Add/Value/Placeholder $:/language/EditTemplate/Shadow/OverriddenWarning TiddlyWiki
UpgradeMechanism:
SampleModal:
WidgetMessage: tm-add-field: ButtonWidget FieldManglerWidget
WidgetMessage: tm-add-tag: ButtonWidget FieldManglerWidget
WidgetMessage: tm-auto-save-wiki: NavigatorWidget SaverModules SyncMechanism TiddlerStore TiddlyWiki WidgetMessage: tm-delete-tiddler WidgetMessage: tm-perform-import WidgetMessage: tm-save-tiddler
WidgetMessage: tm-browser-refresh: ButtonWidget
WidgetMessage: tm-cancel-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-clear-password: $:/isEncrypted ButtonWidget EncryptionMechanism
WidgetMessage: tm-close-all-tiddlers: ButtonWidget NavigatorWidget StoryList
WidgetMessage: tm-close-other-tiddlers: ButtonWidget NavigatorWidget StoryList
WidgetMessage: tm-close-tiddler: ButtonWidget NavigatorWidget StoryList
WidgetMessage: tm-copy-to-clipboard: $:/language/Notifications/CopiedToClipboard/Failed $:/language/Notifications/CopiedToClipboard/Succeeded ButtonWidget TiddlyWiki
WidgetMessage: tm-delete-tiddler: ButtonWidget NavigatorWidget StoryList
WidgetMessage: tm-download-file: ButtonWidget HashMap SaverModules SyncMechanism TiddlyWiki
WidgetMessage: tm-edit-bitmap-operation: $:/core/ui/EditorToolbar/size-dropdown ActionWidget ButtonWidget
WidgetMessage: tm-edit-text-operation: $:/core/ui/EditorToolbar/bold ActionWidget ButtonWidget
WidgetMessage: tm-edit-tiddler: ActionSendMessageWidget ButtonWidget NavigatorWidget StoryList
WidgetMessage: tm-focus-selector:
WidgetMessage: tm-fold-all-tiddlers: ButtonWidget NavigatorWidget
WidgetMessage: tm-fold-other-tiddlers: ButtonWidget NavigatorWidget
WidgetMessage: tm-fold-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-full-screen:
WidgetMessage: tm-home: $:/DefaultTiddlers ButtonWidget PermaLinks
WidgetMessage: tm-import-tiddlers: $:/Import BrowseWidget DropzoneWidget NavigatorWidget UpgradeMechanism
WidgetMessage: tm-load-plugin-from-library: ButtonWidget CodeMirror
WidgetMessage: tm-load-plugin-library: ButtonWidget
WidgetMessage: tm-login: $:/status/IsLoggedIn $:/status/UserName SyncAdaptorModules SyncMechanism
WidgetMessage: tm-logout: $:/status/IsLoggedIn $:/status/UserName SyncAdaptorModules SyncMechanism
WidgetMessage: tm-modal: ButtonWidget HashMap
WidgetMessage: tm-navigate: ActionNavigateWidget ButtonWidget HistoryList LinkWidget NavigatorWidget StoryList
WidgetMessage: tm-new-tiddler: ActionSendMessageWidget ButtonWidget HashMap NavigatorWidget StoryList TiddlerFields
WidgetMessage: tm-notify:
WidgetMessage: tm-open-external-window: ActionSendMessageWidget ButtonWidget
WidgetMessage: tm-open-window: ButtonWidget
WidgetMessage: tm-perform-import: $:/Import ButtonWidget NavigatorWidget TiddlerStore UpgradeMechanism
WidgetMessage: tm-permalink: ButtonWidget PermaLinks StoryMechanism
WidgetMessage: tm-permaview: ButtonWidget PermaLinks StoryMechanism StoryRiver
WidgetMessage: tm-print: ButtonWidget
WidgetMessage: tm-remove-field: ButtonWidget FieldManglerWidget
WidgetMessage: tm-remove-tag: ButtonWidget FieldManglerWidget
WidgetMessage: tm-rename-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-save-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-save-wiki: ButtonWidget HashMap SaverModule SaverModules SyncMechanism
WidgetMessage: tm-scroll: ScrollableWidget
WidgetMessage: tm-server-refresh: SyncAdaptorModules SyncMechanism
WidgetMessage: tm-set-password: $:/isEncrypted ButtonWidget EncryptionMechanism
WidgetMessage: tm-unfold-all-tiddlers: ButtonWidget NavigatorWidget
WidgetMessage: tm-unload-plugin-library: ButtonWidget
Building TiddlyWikiClassic: FieldsWidget JavaScript TiddlyWiki TiddlyWiki on Node.js TiddlyWiki5 TiddlyWikiClassic ViewWidget
Customising Tiddler File Naming: $:/config/FileSystemPaths Filter Syntax task TiddlyWiki on Node.js TiddlyWikiFolders
Environment Variables on Node.js: GitHub InitCommand TiddlyWiki on Node.js TiddlyWiki5
Installing TiddlyWiki Prerelease on Node.js: GitHub npm TiddlyWiki5
Installing TiddlyWiki on Node.js: GitHub Node.js TiddlyWiki
Naming of System Tiddlers: JavaScript TiddlyWiki
Scripts for TiddlyWiki on Node.js: LazyLoading Scripts for building tiddlywiki.com TiddlyWiki TiddlyWiki5
Serving TW5 from Android: Installing TiddlyWiki on Node.js TiddlyWiki on Node.js Using TiddlyWiki on Node.js
TiddlyWiki on Node.js: Installing TiddlyWiki on Node.js Node.js Upgrading TiddlyWiki on Node.js Using TiddlyWiki on Node.js
TiddlyWiki5 Versioning: TiddlyWiki TiddlyWiki5
Upgrading TiddlyWiki on Node.js: TiddlyWiki on Node.js
Using TiddlyWiki on Node.js: TiddlerFiles TiddlyWikiFolders
Working with the TiddlyWiki5 repository: Contributing GitHub Installing TiddlyWiki on Node.js npm Scripts for TiddlyWiki on Node.js TiddlyWiki TiddlyWiki5 Working with the TiddlyWiki5 repository video
tiddlywiki.files Files: LazyLoading Release 5.1.14 TiddlerFiles TiddlyWikiFolders
tiddlywiki.info Files: $:/config/OriginalTiddlerPaths BuildCommand TiddlyWikiFolders
Beaker Browser: Saving on Beaker Browser TiddlyWiki
Platforms: TiddlyWiki
TiddlyFox Apocalypse: Beaker Browser GettingStarted TiddlyDesktop TiddlyFox TiddlyWiki
TiddlyWiki in the Sky for TiddlyWeb: TiddlySpace TiddlyWeb TiddlyWiki
Amazon Web Services Plugin: JavaScript TiddlyWiki
BrowserStorage Plugin: TiddlyWiki
CodeMirror Plugin:
D3 Plugin:
Disabling Plugins:
Dynaview Plugin:
External Attachments Plugin: TiddlyDesktop TiddlyWiki
Highlight Plugin:
Innerwiki Plugin: TiddlyWiki
Installing a plugin from the plugin library: $:/ControlPanel The First Rule of Using TiddlyWiki TiddlyWiki
KaTeX Plugin:
Manually installing a plugin: The First Rule of Using TiddlyWiki
Markdown Plugin: WikiText
Mobile Drag And Drop Shim Plugin:
OfficialPlugins: Installing a plugin from the plugin library TiddlyWiki UpgradeMechanism Working with the TiddlyWiki5 repository
Plugin Editions:
PluginFolders:
Plugin Fields:
Plugin Information Tiddlers: $:/ControlPanel $:/core/en-GB/readme $:/core/icon $:/core/readme TiddlyWiki TranscludeWidget
Plugins: Installing a plugin from the plugin library JavaScript PluginMechanism Resources
Railroad Plugin: $:/plugins/tiddlywiki/railroad/syntax
SaveTrail Plugin: TiddlyWiki
TW2Parser Plugin: WikiText
Twitter Plugin:
Uninstalling a plugin: $:/ControlPanel The First Rule of Using TiddlyWiki
ContributingTemplate: TiddlyWiki5
ReadMe: JavaScript TiddlyWiki WikiText
ReadMeBinFolder:
TiddlyWiki2ReadMe: TiddlyWikiClassic
Reference:
BetaReleases: TiddlyWiki5 TiddlyWiki5 Versioning
Release 5.1.0: TiddlyWiki
Release 5.1.1: ButtonWidget KaTeX Plugin Release 5.0.17-beta TiddlyWiki
Release 5.1.10: $:/AdvancedSearch $:/ControlPanel ActionListopsWidget ActionSetFieldWidget ActionWidgets Alice in Wonderland Blog Edition days Operator EditTextWidget FieldManglerWidget GitHub Hidden Setting: Keyboard Shortcuts Highlight Plugin How to apply custom styles by tag JavaScript KaTeX KeyboardWidget LazyLoading RenderTiddlerCommand Résumé Builder Edition SaveTiddlersCommand SelectWidget ServerCommand tabs Macro Text-Slicer Edition TiddlerLinks TiddlyWiki TiddlyWikiFolders WikiText
Release 5.1.11: Release 5.1.10
Release 5.1.12: $:/AdvancedSearch ActionWidgets CodeMirror colour-picker Macro Customising Tiddler File Naming days Operator EditShortcutWidget EntityWidget has Operator image-picker Macro KaTeX LinkCatcherWidget ScrollableWidget SelectWidget Table-of-Contents Macros TiddlyWiki Upgrading ViewWidget WebDav WikifyWidget WikiText
Release 5.1.13: KaTeX Plugin TiddlyWiki
Release 5.1.14: $:/AdvancedSearch $:/ControlPanel $:/core/images/print-button $:/Manager all Operator Block Quotes in WikiText CheckboxWidget decodehtml Operator decodeuri Operator decodeuricomponent Operator Drag and Drop encodehtml Operator encodeuri Operator encodeuricomponent Operator enlist Operator escaperegexp Operator FetchCommand has Operator HighlightPlugin InfoMechanism is Operator JavaScript KaTeX Plugin KeyboardWidget minlength Operator move Operator order Operator RenderTiddlerCommand SaveTrail Plugin SetWidget stringify Operator Table-of-Contents Macros tag Operator TiddlyFox TiddlyWiki TiddlyWiki on Beaker Browser tiddlywiki.files Files TiddlyWikiFolders Twitter Plugin WikifyWidget wikiparserrules Operator XLSX Utilities Edition
Release 5.1.15: $:/themes/tiddlywiki/vanilla/themetweaks Amazon Web Services Plugin Beaker Browser BrowseWidget DateFormat DropzoneWidget External Attachments Plugin ExternalImages FetchCommand ImportCommand JavaScript jsonstringify Operator LinkCatcherWidget lookup Operator Pragma RenderCommand RenderTiddlerCommand RenderTiddlersCommand SaveCommand SaveTiddlerCommand SaveTiddlersCommand SetWidget TiddlyDesktop TiddlyWiki tree Macro ViewWidget
Release 5.1.16: CheckboxWidget copy-to-clipboard Macro Custom data-styles DiffTextWidget DraggableWidget DroppableWidget Dynaview Plugin each Operator InfoMechanism is Operator KaTeX Plugin LinkWidget list-links Macro list-tagged-draggable Macro Macro Definitions in WikiText RadioWidget RangeWidget RevealWidget SelectWidget ServerCommand SetWidget sortan Operator StartupActions subtiddlerfields Operator tabs Macro TaskManagementExample (Draggable) Text-Slicer Edition The Extended Listops Filters TiddlyWiki ViewTemplate WidgetMessage: tm-copy-to-clipboard
Release 5.1.17: $:/status/UserName is Operator TiddlyWiki
Release 5.1.18: $:/ControlPanel $:/plugins/tiddlywiki/comments $:/SiteTitle $:/TagManager $tw.platform.isLinux ButtonWidget contains Operator Creating a splash screen decodeuri Operator decodeuricomponent Operator Filter Expression Hidden Setting: Scroll Top Adjustment How to create keyboard shortcuts ImportVariablesWidget JavaScript KaTeX KaTeX Plugin LinkWidget list-tagged-draggable Macro ListenCommand NamedCommandParameters Pragma range Operator RevealWidget search Operator ServerCommand subfilter Operator Table-of-Contents Macros tag Macro TiddlyWiki tree Macro tv-adjust-heading-level Variable tv-show-missing-links Variable Using HTTPS Using the external JavaScript template Using the integrated static file server Using the read-only single tiddler view WebServer WebServer Authorization WebServer Parameter: authenticated-user-header WebServer Parameter: credentials WebServer Parameter: csrf-disable WebServer Parameter: debug-level WidgetMessage: tm-edit-text-operation WidgetMessage: tm-full-screen WidgetMessage: tm-new-tiddler
Release 5.1.19: ButtonWidget Hidden Setting: Filename for Save Wiki Button KaTeX Plugin Release 5.1.18 TiddlyWiki WebServer
Release 5.1.2: KaTeX Plugin TiddlySpot TiddlyWiki
Release 5.1.20: $:/AdvancedSearch $:/ControlPanel $:/info/browser/language $:/PaletteManager abs Operator add Operator Amazon Web Services Plugin BrowserStorage Plugin ceil Operator CheckboxWidget CodeMirror CodeMirror Plugin Conditional Operators DeleteTiddlersCommand divide Operator dumpvariables Macro Dynaview Plugin EditBitmapWidget else Operator enlist Operator escapecss Operator exponential Operator field Operator fixed Operator floor Operator getvariable Operator Hidden Setting: Search AutoFocus Hidden Setting: ViewTemplate and EditTemplate Highlight Plugin InfoMechanism Innerwiki Plugin is Operator JavaScript join Operator KaTeX Plugin length Operator LinkWidget ListenCommand LoadCommand lowercase Operator match Operator Mathematics Operators max Operator maxall Operator min Operator minall Operator multiply Operator negate Operator Performance Instrumentation precision Operator product Operator remainder Operator RevealWidget round Operator SaveWikiFolderCommand Saving to a Git service SelectWidget sentencecase Operator sign Operator split Operator splitregexp Operator StartupActions subtract Operator sum Operator tag Operator then Operator TiddlySpot TiddlyWiki TiddlyWikiFolders titlecase Operator trim Operator trunc Operator untrunc Operator unusedtitle Macro uppercase Operator Using TiddlyWiki on Node.js variables Operator WebServer WidgetMessage: tm-focus-selector WidgetMessage: tm-open-window
Release 5.1.21: ActionDeleteFieldWidget Customising Tiddler File Naming External Attachments Plugin field Operator Release 5.1.20 Saving to a Git service Table-of-Contents Macros TiddlyWiki Translate TiddlyWiki into your language WikiText
Release 5.1.3: ActionWidgets Audio Creating and editing tiddlers Creating journal tiddlers ImageWidget LaTeX TiddlyWiki
Release 5.1.4: Release 5.1.3 TiddlyWiki ViewWidget
Release 5.1.5: $:/AdvancedSearch $:/ControlPanel $:/core/images/video $:/TagManager ActionDeleteFieldWidget ActionDeleteTiddlerWidget ActionSetFieldWidget CodeMirror Customising search results EditionsCommand EditTextWidget Example Table of Contents: Tabbed Internal ImageGallery Example RevealWidget Table-of-Contents Macros TiddlyWiki TiddlyWikiFolders UnpackPluginCommand WidgetMessage: tm-download-file WidgetMessage: tm-modal WidgetMessage: tm-new-tiddler WidgetMessage: tm-save-wiki
Release 5.1.6: BrowseWidget InitCommand Table-of-Contents Macros TiddlyWiki
Release 5.1.7: GettingStarted Release 5.1.6
Release 5.1.8: $:/AdvancedSearch $:/ControlPanel $:/TagManager CheckboxWidget eachday Operator editiondescription Operator editions Operator Filter Syntax Help Plugin Highlight Plugin ImageGallery Example KaTeX Plugin Railroad Plugin RenderTiddlersCommand resolvepath Macro RevealWidget sameday Operator Setting a page background image TiddlyWiki
Release 5.1.9: $:/ControlPanel ActionSendMessageWidget ButtonWidget CodeMirror Hidden Setting: Search AutoFocus Hidden Setting: Typing Refresh Delay Hidden Settings Releases TiddlyDesktop TiddlyWiki tv-tiddler-preview Variable VarsWidget
ReleaseTemplate:
Releases:
TiddlyWiki Releases: AlphaReleases BetaReleases TiddlyWiki5 TiddlyWiki5 Versioning
AlphaReleases: TiddlyWiki5 TiddlyWiki5 Versioning
Release 5.0.0-alpha.11: BrowseWidget DropzoneWidget EditBitmapWidget EditTextWidget EditWidget ListWidget NavigatorWidget SetVariableWidget TiddlyWiki5 TranscludeWidget ViewWidget
Release 5.0.0-alpha.12: TiddlyWeb TiddlyWiki5
Release 5.0.0-alpha.13: $:/tags/ControlPanel $:/tags/MoreSideBar $:/tags/SideBar $:/tags/TiddlerInfo CodeMirror DaveGifford ViewWidget
Release 5.0.0-alpha.14: $:/ControlPanel CheckboxWidget PasswordWidget
Release 5.0.0-alpha.15: $:/tags/EditTemplate $:/tags/EditToolbar $:/tags/PageControls $:/tags/ViewToolbar TiddlyWeb TranscludeWidget
Release 5.0.0-alpha.16: $:/LeftSideBar $:/TopSideBar Node.js SavingMechanism ServerCommand TiddlySpot TiddlyWiki5 TiddlyWikiFolders WikiText
Release 5.0.0-alpha.17:
Release 5.0.1-alpha: Block Quotes in WikiText GitHub StephanHradek TiddlyWiki5 Versioning Upgrading
Changes to filters in 5.0.9-beta:
Notes for upgrading to 5.0.11-beta: OutputCommand TiddlyWikiFolder
Notes for upgrading to 5.0.8-beta: $:/SiteSubtitle $:/SiteTitle InitCommand SiteSubtitle SiteTitle TiddlyWiki TiddlyWiki on Node.js
Release 5.0.10-beta: DateFormat Images in WikiText ImageWidget SafeMode TiddlyWeb
Release 5.0.11-beta: $:/AdvancedSearch $:/core/ui/PageMacros $:/core/wiki/title BuildCommand ClearPasswordCommand CodeBlockWidget CodeMirror JavaScript Linking in WikiText Notes for upgrading to 5.0.11-beta OutputCommand PermaLinks StartupMechanism The First Rule of Using TiddlyWiki TiddlerFiles TiddlyWiki TiddlyWikiFolders WikiLinks WikiText
Release 5.0.12-beta:
Release 5.0.13-beta: $:/ControlPanel $:/tags/RawMarkup CodeMirror Environment Variables on Node.js ExternalImages HTML in WikiText ImportVariablesWidget LinkWidget Macros in WikiText PermaLinks SaveTiddlersCommand SelectWidget ServerCommand SetFieldCommand TableOfContents TextWidget TiddlyWiki Widgets in WikiText
Release 5.0.14-beta: $:/ControlPanel $:/core/modules/upgraders/plugins.js $:/core/modules/upgraders/system.js $:/core/modules/upgraders/themetweaks.js $:/HistoryList $:/StoryList $:/TagManager BuildCommand CamelCase CheckboxWidget Filter Parameter ImportMechanism InfoMechanism ReleaseHistory SystemTags TiddlerWidget TiddlyWiki TranscludeWidget UpgradeLibrary UpgradePlugin UpgraderModules WidgetMessage: tw-permalink WidgetMessage: tw-permaview
Release 5.0.15-beta: $:/ControlPanel $:/TagManager DropzoneWidget ImageWidget PluginMechanism Startup Modules.svg Table-of-Contents Macros TiddlyWiki WidgetMessage: tw-browser-refresh WidgetMessage: tw-home
Release 5.0.16-beta: Configuring the default TiddlerInfo tab Table-of-Contents Macros TiddlyWiki TiddlyWikiClassic WidgetMessage: tw-browser-refresh
Release 5.0.17-beta: $:/ControlPanel BrowseWidget ButtonWidget ImageWidget LinkWidget RegExp SafeMode Table-of-Contents Macros TiddlyWiki
Release 5.0.18-beta: RadioWidget TiddlyWiki
Release 5.0.2-beta: DavidJade GitHub Hard Linebreaks in WikiText InternetExplorer JavaScript Macros PluginMechanism RadioWidget Saving on InternetExplorer Saving with TiddlyIE StephanHradek TiddlyFox TiddlyWeb
Release 5.0.3-beta:
Release 5.0.4-beta: DavidJade GitHub InternetExplorer RadioWidget SaveTiddlerCommand StephanHradek TiddlyWiki on Node.js TiddlyWikiFolders Using favicons
Release 5.0.5-beta: Setting a favicon
Release 5.0.6-beta: $:/AdvancedSearch DavidJade Formatting in WikiText InternetExplorer ServerCommand StephanHradek Tables in WikiText TiddlerFilters TiddlyWiki on node-webkit
Release 5.0.7-beta: $:/AdvancedSearch $:/ControlPanel $:/DefaultTiddlers $:/plugins/tiddlywiki/nodewebkitsaver GitHub Naming of System Tiddlers node-webkit Saving on a PHP Server ServerCommand TemplateTiddlers TextReference TextWidget TiddlerFilters TiddlyDesktop TiddlyFox TiddlyWiki TiddlyWiki Coding Style Guidelines TiddlyWiki on Firefox for Android Video ViewWidget
Release 5.0.8-beta: $:/AdvancedSearch $:/ControlPanel $:/SiteSubtitle $:/SiteTitle $:/TagManager AlertMechanism AutoSave BramChen ButtonWidget ColourPalettes EditBitmapWidget HelpCommand How to create plugins in the browser InitCommand KeyboardWidget LazyLoading MultiTiddlerFiles Notes for upgrading to 5.0.8-beta RevealWidget SiteSubtitle SiteTitle TiddlerFilter Formal Grammar TiddlerFilters TiddlyWeb TiddlyWiki on Node.js TranscludeWidget TranslationMechanism ViewWidget WidgetMessages
Release 5.0.9-beta: $:/AdvancedSearch $:/ControlPanel $:/TagManager ButtonWidget CecilyView Changes to filters in 5.0.9-beta Community Developing plugins using Node.js and GitHub LinkWidget Making curved text with SVG ScrollableWidget TiddlerFilters TiddlerTags TiddlyWeb TiddlyWiki TiddlyWiki Architecture TiddlyWikiClassic Transclusion in WikiText WidgetMessage: tw-home
RoadMap: GitHub TiddlyWiki
Emergency Tiddler Export: TiddlyWiki
Encryption: ServerCommand Stanford JavaScript Crypto Library TiddlySpot TiddlyWIki TiddlyWiki on Node.js TiddlyWiki5
Example config-tiddlyweb-host for IIS:
Example package.json for IIS:
Example tiddlywiki.info for IIS:
Example web.config for IIS:
Installing TiddlyWiki on Microsoft Internet Information Server: Node.js TiddlyWiki
Saving on Android: TiddlyWiki TiddlyWiki5
Saving on Beaker Browser: Beaker Browser TiddlyWiki
Saving on TiddlyDesktop: Introducing TiddlyDesktop Video TiddlyDesktop TiddlyWiki
Saving on TiddlySpot: $:/ControlPanel BrowserCompatibility Saving with TiddlyFox TiddlySpot
Saving on a PHP Server: $:/ControlPanel TiddlySpot
Saving on iPad/iPhone: TiddlyWiki TiddlyWiki5
Saving to a Git service: $:/ControlPanel GitHub GitLab personal access token TiddlyWiki
Saving via WebDAV: "Wikilabs" by PMario HowTo TiddlyWiki Upgrading WebDAV
Saving via a Minimal Ruby Server:
Saving with TiddlyFox on Android: Firefox for Android TiddlyFox TiddlyWiki TiddlyWiki on Firefox for Android Video
Saving with TiddlyFox: Saving with TiddlyFox on Android TiddlyFox TiddlyWiki
Saving with TiddlyIE: TiddlyIE TiddlyWiki
Saving with the HTML5 fallback saver: TiddlyWiki
Saving:
TiddlyWiki Cloud: TiddlyWiki
Documentation Macros: $:/ControlPanel InfoPanel
Documentation Style Guide: Documentation Macros Instruction Tiddlers Reference Tiddlers Spelling Technical Prose Style Tiddler Structure Tiddler Title Policy Typography
Instruction Tiddlers: Reference Tiddlers
Reference Tiddlers:
Spelling: JavaScript
Technical Prose Style: Instruction Tiddlers
Tiddler Structure: Philosophy of Tiddlers Reference Tiddlers
Tiddler Title Policy: CamelCase JavaScript Reference Tiddlers TiddlyWiki
Typography: Documentation Macros
Deprecated - What does it mean: Custom styles by tag
SystemTag: $:/tags/AboveStory: SystemTags
SystemTag: $:/tags/AdvancedSearch: SystemTags
SystemTag: $:/tags/AdvancedSearch/FilterButton: SystemTags
SystemTag: $:/tags/Alert: SystemTags
SystemTag: $:/tags/BelowStory: SystemTags
SystemTag: $:/tags/ControlPanel: SystemTags
SystemTag: $:/tags/ControlPanel/Advanced: SystemTags
SystemTag: $:/tags/ControlPanel/Appearance: SystemTags
SystemTag: $:/tags/ControlPanel/Info: SystemTags
SystemTag: $:/tags/ControlPanel/Saving: SystemTags
SystemTag: $:/tags/ControlPanel/Settings: SystemTags
SystemTag: $:/tags/ControlPanel/Toolbars: SystemTags
SystemTag: $:/tags/EditPreview: SystemTags
SystemTag: $:/tags/EditTemplate: SystemTags
SystemTag: $:/tags/EditToolbar: SystemTags
SystemTag: $:/tags/EditorToolbar: SystemTags
SystemTag: $:/tags/Exporter: SystemTags
SystemTag: $:/tags/Filter: SystemTags
SystemTag: $:/tags/Image: SystemTags
SystemTag: $:/tags/ImportPreview: SystemTags
SystemTag: $:/tags/KeyboardShortcut: Keyboard Shortcut Descriptor Keyboard Shortcut Tiddler SystemTags
SystemTag: $:/tags/Macro: SystemTags
SystemTag: $:/tags/Manager/ItemMain: $:/Manager SystemTags
SystemTag: $:/tags/Manager/ItemSidebar: SystemTags
SystemTag: $:/tags/MoreSideBar: SystemTags
SystemTag: $:/tags/MoreSideBar/Plugins: SystemTags
SystemTag: $:/tags/PageControls: SystemTags
SystemTag: $:/tags/PageTemplate: SystemTags
SystemTag: $:/tags/Palette: SystemTags
SystemTag: $:/tags/PluginLibrary: SystemTags
SystemTag: $:/tags/RawMarkup: SystemTags
SystemTag: $:/tags/RawMarkupWikified: ImportVariablesWidget SystemTags
SystemTag: $:/tags/RawMarkupWikified/BottomBody: ImportVariablesWidget SystemTags
SystemTag: $:/tags/RawMarkupWikified/TopBody: ImportVariablesWidget SystemTags
SystemTag: $:/tags/RawMarkupWikified/TopHead: ImportVariablesWidget SystemTags
SystemTag: $:/tags/RawStaticContent: SystemTags
SystemTag: $:/tags/RemoteAssetInfo: SystemTags
SystemTag: $:/tags/SearchResults: SystemTags
SystemTag: $:/tags/ServerConnection: SystemTags
SystemTag: $:/tags/SideBar: SystemTags
SystemTag: $:/tags/SideBarSegment: SystemTags
SystemTag: $:/tags/StartupAction: SystemTags
SystemTag: $:/tags/StartupAction/Browser: SystemTags
SystemTag: $:/tags/StartupAction/Node: SystemTags
SystemTag: $:/tags/Stylesheet: SystemTags
SystemTag: $:/tags/TagDropdown: SystemTags
SystemTag: $:/tags/Texteditor/Snippet: SystemTags
SystemTag: $:/tags/TiddlerInfo: SystemTags
SystemTag: $:/tags/TiddlerInfoSegment: SystemTags
SystemTag: $:/tags/TiddlerInfo/Advanced: SystemTags
SystemTag: $:/tags/ToolbarButtonStyle: SystemTags
SystemTag: $:/tags/TopLeftBar: SystemTags
SystemTag: $:/tags/TopRightBar: SystemTags
SystemTag: $:/tags/ViewTemplate: SystemTags
SystemTag: $:/tags/ViewToolbar: SystemTags
TiddlyDesktop Releases: TiddlyDesktop
Core Variables: Variables
Variables: Core Variables Macros Variables in WikiText Widgets WikiText
currentTiddler Variable: Current Tiddler TemplateTiddlers Variables WikiText
storyTiddler Variable: $:/core/ui/EditTemplate $:/core/ui/PageTemplate/story $:/core/ui/ViewTemplate Variables Widgets
transclusion Variable: Current Tiddler Transclusion Variables Widgets
actionTiddler Variable: DroppableWidget Title List Variables
Sample Headings 1,2,3:
Sample Headings 3,4,5:
Sample Headings 4,5,6:
currentTiddler Variable (Examples):
storyTiddler Variable (Examples):
transclusion Variable (Examples):
tv-adjust-heading-level Variable (Examples):
tv-config-toolbar-class Variable (Examples): Cascading Style Sheets
tv-config-toolbar-icons Variable (Examples):
tv-config-toolbar-text Variable (Examples):
tv-get-export-image-link Variable (Examples):
tv-wikilink-tooltip Variable (Examples): HelloThere
tv-wikilinks Variable (Examples):
modifier Variable: DroppableWidget Variables
namespace Variable: Document Object Model HyperText Markup Language Variables
tv-adjust-heading-level Variable: Headings in WikiText Variables
tv-auto-open-on-import Variable: $:/Import StoryRiver Variables
tv-config-toolbar-class Variable: Cascading Style Sheets Variables
tv-config-toolbar-icons Variable: Variables
tv-config-toolbar-text Variable: Variables
tv-filter-export-link Variable: tv-wikilink-template Variable Variables
tv-get-export-image-link Variable: Images in WikiText Macros TiddlyWiki on Node.js Variables
tv-get-export-link Variable: Macros Variables
tv-get-export-path Variable: Percent Encoding TiddlyWiki on Node.js Variables
tv-history-list Variable: NavigatorWidget Variables
tv-show-missing-links Variable: $:/ControlPanel Variables
tv-story-list Variable: NavigatorWidget Variables
tv-tiddler-preview Variable: Variables
tv-wikilink-template Variable: Macros Percent Encoding Variables
tv-wikilink-tooltip Variable: Macros Variables WikiText
tv-wikilinks Variable: Variables
Getting Started Video: TiddlyWIki
Introducing TiddlyDesktop Video: TiddlyDesktop
Introduction Video: TiddlyWiki
TiddlyWiki on Firefox for Android Video: TiddlyWiki
Videos: Contributing TiddlyWiki
Working with the TiddlyWiki5 repository video: Working with the TiddlyWiki5 repository
TiddlyWeb JSON tiddler format: TiddlyWeb
Using HTTPS: TiddlyWiki WebServer WebServer Parameter: tls-cert WebServer Parameter: tls-key
Using the external JavaScript template: JavaScript TiddlyWiki WebServer Parameter: root-tiddler
Using the integrated static file server: ExternalImages
Using the read-only single tiddler view: TiddlyWiki WebServer Parameter: system-tiddler-render-template WebServer Parameter: system-tiddler-render-type WebServer Parameter: tiddler-render-template WebServer Parameter: tiddler-render-type
WebServer API: TiddlyWiki WebServer
WebServer API: Delete Tiddler:
WebServer API: Force Basic Authentication Login:
WebServer API: Get All Tiddlers: TiddlyWeb JSON tiddler format
WebServer API: Get Favicon: $:/favicon.ico
WebServer API: Get File: Using the integrated static file server
WebServer API: Get Rendered Tiddler: Using the read-only single tiddler view
WebServer API: Get Server Status: TiddlyWiki WebServer Parameter: anon-username
WebServer API: Get Tiddler: TiddlyWeb JSON tiddler format
WebServer API: Get Wiki: WebServer Parameter: root-render-type WebServer Parameter: root-serve-type WebServer Parameter: root-tiddler
WebServer API: Put Tiddler: TiddlyWeb JSON tiddler format
WebServer Anonymous Access: WebServer Parameter: readers WebServer Parameter: writers
WebServer Authentication: TiddlyWiki WebServer Anonymous Access WebServer Basic Authentication WebServer Header Authentication
WebServer Authorization: $:/status/IsReadOnly TiddlyWiki WebServer WebServer Authentication WebServer Parameter: credentials WebServer Parameter: readers WebServer Parameter: writers
WebServer Basic Authentication: WebServer Authentication WebServer Authorization WebServer Parameter: credentials WebServer Parameter: password WebServer Parameter: username
WebServer Guides: WebServer
WebServer Header Authentication: WebServer Parameter: authenticated-user-header
WebServer Parameter: anon-username: WebServer Parameters
WebServer Parameter: authenticated-user-header: TiddlyWiki WebServer Header Authentication WebServer Parameters
WebServer Parameter: credentials: WebServer Basic Authentication WebServer Parameter: password WebServer Parameter: username WebServer Parameters
WebServer Parameter: csrf-disable: WebServer Parameters
WebServer Parameter: debug-level: WebServer Parameters
WebServer Parameter: host: WebServer Parameters
WebServer Parameter: password: WebServer Basic Authentication WebServer Parameter: username WebServer Parameters
WebServer Parameter: path-prefix: WebServer Parameters
WebServer Parameter: port: WebServer Parameters
WebServer Parameter: readers: WebServer Authorization WebServer Parameters
WebServer Parameter: root-render-type: WebServer Parameter: root-tiddler WebServer Parameters
WebServer Parameter: root-serve-type: WebServer Parameters
WebServer Parameter: root-tiddler: WebServer Parameters
WebServer Parameter: system-tiddler-render-template: Using the read-only single tiddler view WebServer Parameters
WebServer Parameter: system-tiddler-render-type: Using the read-only single tiddler view WebServer Parameters
WebServer Parameter: tiddler-render-template: Using the read-only single tiddler view WebServer Parameters
WebServer Parameter: tiddler-render-type: Using the read-only single tiddler view WebServer Parameters
WebServer Parameter: tls-cert: Using HTTPS WebServer Parameters
WebServer Parameter: tls-key: Using HTTPS WebServer Parameters
WebServer Parameter: username: WebServer Basic Authentication WebServer Parameter: credentials WebServer Parameter: password WebServer Parameter: readers WebServer Parameter: writers WebServer Parameters
WebServer Parameter: writers: WebServer Authorization WebServer Parameters
WebServer Parameters: WebServer
WebServer: ListenCommand NamedCommandParameters ServerCommand TiddlyWiki TiddlyWiki on Node.js WebServer WebServer Anonymous Access WebServer API WebServer Authentication WebServer Authorization WebServer Basic Authentication WebServer Header Authentication WebServer Parameter: host WebServer Parameter: password WebServer Parameter: readers WebServer Parameter: username WebServer Parameter: writers
ActionCreateTiddlerWidget: ActionWidgets ButtonWidget StoryRiver WidgetMessage: tm-new-tiddler
ActionCreateTiddlerWidget Example:
ActionDeleteFieldWidget: ActionWidgets ButtonWidget Current Tiddler HelloThere
ActionDeleteTiddlerWidget: ActionWidgets ButtonWidget HelloThere TableOfContents WidgetMessage: tm-delete-tiddler
ActionListopsWidget: ActionWidgets ButtonWidget Current Tiddler DataTiddlers The Extended Listops Filters
ActionNavigateWidget: ActionWidgets ButtonWidget Current Tiddler WidgetMessage: tm-navigate
ActionSendMessageWidget: ActionWidgets ButtonWidget Messages WidgetMessage: tm-new-tiddler
ActionSetFieldWidget: ActionWidgets ButtonWidget Current Tiddler DataTiddlers HelloThere
ActionWidgets: ButtonWidget
BrowseWidget: JavaScript NavigatorWidget TiddlyWiki WidgetMessage: tm-import-tiddlers
ButtonWidget: Accessibility ActionWidgets DraggableWidget Messages PopupMechanism TextReference TiddlerA TiddlerB Transclusion in WikiText
CheckboxWidget: ActionWidgets Current Tiddler DataTiddlers ExampleData
CodeBlockWidget: Highlight Plugin
CountWidget: Filters
DiffTextWidget: $:/language/Diffs/CountMessage
DraggableWidget: actionTiddler Variable DragAndDropMechanism DraggableWidget LinkWidget Mobile Drag And Drop Shim Plugin Title List
DroppableWidget: actionTiddler Variable DragAndDropMechanism DroppableWidget Mobile Drag And Drop Shim Plugin modifier Variable
DropzoneWidget: JavaScript LinkWidget NavigatorWidget WidgetMessage: tm-import-tiddlers
EditBitmapWidget: $:/config/BitmapEditor/Colour $:/config/BitmapEditor/LineWidth Current Tiddler
EditTextWidget: AppSettings ChangeAppSettings Current Tiddler EditTextWidget GettingStarted ShadowTiddlers TemplateTiddlers
EditWidget: Current Tiddler EditBitmapWidget EditTextWidget
EncryptWidget: BootMechanism EncryptionMechanism PasswordVault TiddlyWiki5
EntityWidget:
FieldMangler Widget (Examples):
FieldManglerWidget: Current Tiddler Messages
FieldsWidget: Current Tiddler FileSavingMechanism TiddlyWiki TiddlyWiki5
ImageWidget: ExternalImages
ImportVariablesWidget: $:/core/ui/PageTemplate Filters ImportVariablesWidget Pragma
KeyboardWidget: ActionWidgets Messages
LinkCatcherWidget: ActionWidgets Messages WidgetMessage: tm-navigate
LinkWidget: Current Tiddler DraggableWidget HelloThere LinkCatcherWidget Macros WikiText
ListWidget: DraftMechanism Filters HistoryMechanism ListView ListWidget NestedLists Variables
ListopsData:
MacroCallWidget: $:/snippets/allfields $:/snippets/modules $:/themes/tiddlywiki/starlight/styles.tid ContentType
NavigatorWidget: HistoryList Messages StoryList StoryRiver TiddlerStore
PasswordWidget: PasswordVault TiddlyWiki5
RadioWidget: AnimalColours Current Tiddler DataTiddlers
RangeWidget: Current Tiddler
RevealWidget: PopupMechanism RevealWidget StateTiddlers TextReference
ScrollableWidget: $:/_tw5.com-styles WidgetMessage: tm-scroll
SelectWidget: $:/SiteTitle ActionWidgets DataTiddlers ListWidget TableOfContents
SetVariableWidget: SetWidget
SetWidget: Variables
TextWidget: WikifyWidget WikiText
The Extended Listops Filters: DaysOfTheWeek
TiddlerWidget: $:/core/ui/ViewTemplate $:/tags/Macro Current Tiddler How to apply custom styles by tag TiddlerWidget
TranscludeWidget: $:/DefaultTiddlers DataTiddlers Plugins SubTiddler TiddlyWiki TranscludeWidget
VarsWidget: SetWidget
ViewWidget: $:/DefaultTiddlers Current Tiddler DateFormat JavaScript Plugins SubTiddler
Widgets: HTML in WikiText Widgets in WikiText WikiText
WikifyWidget: ContentType Variables
Block Quotes in WikiText: Lists in WikiText TiddlyWiki5
Code Blocks in WikiText:
Dashes in WikiText:
Definitions in WikiText:
Formatting in WikiText: Code Blocks in WikiText
HTML in WikiText: Filter Expression Macro Calls in WikiText Macros in WikiText TextReference Widgets in WikiText WikiText
HTML Links in WikiText: MyLinkDestination TiddlyWiki
Hard Linebreaks in WikiText: Paragraphs in WikiText
Headings in WikiText:
Horizontal Rules in WikiText:
Images in WikiText: ImageWidget TextReference Transclusion WikiText
Linking in WikiText: CamelCase LinkWidget WikiText
Lists in WikiText: Block Quotes in WikiText
Macro Calls in WikiText: Macro Call Syntax Macro Calls in WikiText (Examples) Macros StateMechanism Transclusion Transclusion with Templates Variables
Macro Definitions in WikiText: Macro Definition Syntax Macros Pragma Title Selection Variables
Macros in WikiText: Macro Calls in WikiText Macro Definitions in WikiText Macros WikiText
Paragraphs in WikiText: Hard Linebreaks in WikiText TiddlyWiki
Styles and Classes in WikiText:
Tables in WikiText: TiddlyWiki5
Transclusion Basic Usage: TextReference TiddlerA TiddlerB TiddlerFields TiddlyWiki Transclusion Transclusion in WikiText Transclusion with Templates
Transclusion and Substitution: HTML in WikiText Introduction to filter notation Macros in WikiText Transclusion in WikiText WikiText
Transclusion in WikiText: Current Tiddler DataTiddlers Filters TemplateTiddlers TextReference TiddlerWidget TranscludeWidget Transclusion Transclusion and Substitution Transclusion Basic Usage Transclusion with Templates WikiText
Transclusion with Templates: Current Tiddler Styles and Classes in WikiText TemplateTiddlers TextReference TranscludeWidget Transclusion Basic Usage Transclusion in WikiText
Typed Blocks in WikiText: ContentType WikiText
Variables in WikiText: Filter Operators Filter Parameter ImportVariablesWidget Macro Calls in WikiText Macro Definitions in WikiText Macros Macros in WikiText Variables Widgets in WikiText
Widgets in WikiText: HTML in WikiText WikiText
Audio: Caruso - Ave Maria Images in WikiText TiddlyWiki.mp3
BrowserCompatibility: TiddlyWiki
Creating and editing tiddlers: AutoSave Creating journal tiddlers cursiva azul ListField WikiText
Creating journal tiddlers: $:/ControlPanel DateFormat Title List
Formatting text in TiddlyWiki: CamelCase Cascading Style Sheets HelloThere History of TiddlyWiki TIddlyWiki WikiText
Navigating between open tiddlers: StoryRiver StoryView
Performance: ExternalImages Performance Instrumentation TiddlyWiki
Sharing your tiddlers with others: How to export tiddlers PermaLinks PermaView Sharing a TiddlyWiki on Dropbox
Using links to navigate between tiddlers: Filters Linking in WikiText ListWidget ShadowTiddlers SystemTiddlers Transclusion in WikiText
Working with TiddlyWiki:
Adding Babel Polyfill to TiddlyWiki: Using ES2016 for Writing Plugins
Adding a Table of Contents to the Sidebar: Table-of-Contents Macros TableOfContents
Glosario en-GB -> es-ES: ListField NavigatorWidget Tables in WikiText
ImportTiddlers:
Información para traductores: $:/editions/es-ES/util-macros Exporter un sous-ensemble de tiddlers Glosario en-GB->es-ES Improving TiddlyWiki Documentation Linking in WikiText
MiSubHistoria:
MySubHistoryList:
MySubStoryList:
Saving on InternetExplorer: InternetExplorer Saving with TiddlyIE Windows HTA Hack
Saving on Safari: TiddlyWiki
TiddlySpot: TiddlyWiki TiddlyWiki5 TiddlyWikiClassic
TitleField:
UsingSVG: $:/SVGExampleRadius HelloThere Motovun Jack.svg Tiddler Fishes.svg WikiText
prueba:
| purpose | filter the input by searching tiddler content |
|---|---|
| input | a selection of titles |
| suffix | the search operator uses a rich suffix, see below for details |
| parameter | one or more search terms, separated by spaces, or a literal search string |
| output | those input tiddlers in which all of the search terms can be found in the value of field F |
! output | those input tiddlers in which not all of the search terms can be found |
New in: 5.1.18 The search filter operator was significantly enhanced in 5.1.18. Earlier versions do not support the extended syntax and therefore do not permit searching multiple fields, or the literal or casesensitive options.
The search operator uses an extended syntax that permits multiple fields and flags to be passed:
[search:<field list>:<flag list>[<operand>]]- field list: a comma delimited list of field names to restrict the search
- defaults to
tags,textandtitleif blank - an asterisk
*instead of the field list causes the search to be performed across all fields available on each tiddler - preceding the list with a minus sign
-reverses the order so that the search is performed on all fields except the listed fields
- defaults to
- flag list: a comma delimited list of flags (defaults to
wordsif blank) - operand: filter operand
This example searches the fields title and caption for a case-sensitive match for the literal string :
[search:title,caption:literal,casesensitive[The first]]The available flags are:
- Search mode - the first to be set of the following flags determines the type of search that is performed:
- literal: considers the search string to be a literal string, and requires an exact match
- whitespace: considers the search string to be a literal string, but will consider all runs of whitespace to be equivalent to a single space. Thus
A BmatchesA B - regexp: treats the search string as a regular expression. Note that the regexp option obviates the need for the older
regexpoperator. - words: (the default) treats the search string as a list of tokens separated by whitespace, and matches if all of the tokens appear in the string (regardless of ordering and whether there is other text in between)
- casesensitive: if present, this flag forces a case-sensitive match, where upper and lower case letters are considered different. By default, upper and lower case letters are considered identical for matching purposes.
- anchored: New in: 5.1.20 anchors the search to the start of the string (applies to whitespace, literal and words modes)
[!is[system]search[table]]
[all[shadows]search[table]]
[search:caption[arch]]
arch in their caption field[search:*[arch]]
arch in any field[search:-title,caption[arch]]
arch in any field except title and caption[!is[system]search[the first]]
[!is[system]search::literal[the first]]
[!is[system]search::literal,casesensitive[The first]]
[search:caption,description:casesensitive,words[arch]]
arch in their caption or description fieldsLa función de búsqueda en TiddlyWiki es rápida y flexible
Búsqueda estándar
El cuadro de búsqueda de la barra lateral devuelve una lista de tiddlers coincidentes con el texto que se escriba en él.
Búsqueda avanzada
Si se pincha en el botón con forma de lupa que hay a la derecha del cuadro de búsqueda, se abre la búsqueda avanzada, que contiene cuatro pestañas.
- Estándar es una instancia más del cuadro de búsqueda estándar de la barra lateral
- Sistema restringe el ámbito de búsqueda a los tiddlers de sistema
- Ocultos restringe el ámbito de búsqueda a los tiddlers ocultos
- Filtro no es en sí un cuadro de búsqueda, sino una manera rápida de obtener una lista de tiddlers que cumplen todas las condiciones de una expresión de filtros. Por ejemplo: "Todas las etitquetas, excepto las de sistema"
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
A simple technique for adding tag-based cross references to the default view template.
See also: - is a feature to generate a "See also:" section after the tiddler text, somewhat like in Wikipedia articles.
El output de un paso depende de su operador:
- La mayoría de operadores obtienen su output a partir del input. Por ejemplo, muchos devuelven un subconjunto del input, cumpliendo así realmente con la función de "filtros", al reducir el output de la instrucción que los contiene. Estos operadores se llaman modificadores de selección.
- Unos pocos operadores, sin embargo, ignoran el input y generan un output independiente. A estos se les llama constructores de selección, porque construyen una selección totalmente nueva.
Un buen ejemplo de constructor es title. El output de [title[A]title[B]] es B, mientras que field es un modificador, por lo que [title[A]field:title[B] no genera output alguno.
Introduction
The select widget displays a popup menu based on a HTML select element. The popup (or dropdown) contains a list of items defined by <option> and <optgroup> elements.
Every time the user selects a new value in the menu, the selected value is written to the text of a specified tiddler field or index and any ActionWidgets within the actions attribute are triggered. Conversely, if the tiddler value is changed independently the select widget is automatically updated to reflect the new value.
In multiple selection mode, the list of selected values is bound to the specified tiddler field or index. Browsers generally use the ctrl or cmd keys for multiple selection.
For example, this select widget displays a list of the tags in this wiki:
<$select tiddler=<<qualify 'select-demo'>> default='HelloThere'>
<$list filter='[all[shadows+tiddlers]tags[]sort[title]]'>
<option value=<<currentTiddler>>><$view field='title'/></option>
</$list>
</$select>Este es su aspecto:
The state tiddler currently contains:
See the text change as you switch entries in the select widget. Try changing the value of the state tiddler and see the select widget change. Notice how the select widget only displays an entry if there is a precise match with the tiddler text.
Content and Attributes
The content of the <$select> widget should be one or more HTML <option> or <optiongroup> elements that provide the available values.
| Attribute | Description |
|---|---|
| tiddler | The title of the tiddler containing the value to be displayed/modified by the select widget (defaults to the current tiddler) |
| field | The field name for the value in the current tiddler (defaults to "text") |
| index | The index of a property in a DataTiddler (takes precedence over the field attribute) |
| class | CSS classes to be assigned to the HTML select element |
| tooltip | Optional tooltip |
| default | Default value to be used if the tiddler, field or index specifies a missing value |
| multiple | If present, switches to multiple selection mode |
| size | The number of rows to display in multiple selection mode |
| actions | A string containing ActionWidgets to be triggered when the key combination is detected |
Examples
Simple Lists
This example sets the title of the current wiki $:/SiteTitle to one of a list of book titles:
<$select tiddler='$:/SiteTitle' tooltip='Choose a new site title'>
<option>A Tale of Two Cities</option>
<option>A New Kind of Science</option>
<option>The Dice Man</option>
</$select>Este es su aspecto:
Value lists
In this example the value attribute has been used to specify the text that should be used as the value of the entry instead of the display text.
<$select tiddler='$:/SiteTitle'>
<option value='cities'>A Tale of Two Cities</option>
<option value='science'>A New Kind of Science</option>
<option value='dice'>The Dice Man</option>
</$select>Este es su aspecto:
Option Groups
Entries in the list can be grouped together with the <optgroup> element
<$select tiddler='$:/SiteTitle'>
<optgroup label='Fiction'>
<option value='cities'>A Tale of Two Cities</option>
<option value='dice'>The Dice Man</option>
</optgroup>
<optgroup label='Non-fiction'>
<option value='science'>A New Kind of Science</option>
<option value='recursive'>The Recursive Universe</option>
</optgroup>
</$select>Este es su aspecto:
Generated Lists
The ListWidget can be used to generate the options for a select widget. For example, here we combine a select widget listing all the tiddlers tagged TableOfContents with a transclusion to display the text of the selected one.
<$select tiddler='$:/generated-list-demo-state'>
<$list filter='[tag[TableOfContents]]'>
<option><$view field='title'/></option>
</$list>
</$select>
<$tiddler tiddler={{$:/generated-list-demo-state}}>
<$transclude mode='block'/>
</$tiddler>Este es su aspecto:
Nested Lists
This example uses a nested pair of list widgets. The outer one generates the <optgroup> elements, and the inner one generates <option> elements:
<$select tiddler='$:/generated-list-demo-nestedstate' field='type' default='text/vnd.tiddlywiki'>
<$list filter='[all[shadows+tiddlers]prefix[$:/language/Docs/Types/]each[group]sort[group]]'>
<optgroup label={{!!group}}>
<$list filter='[all[shadows+tiddlers]prefix[$:/language/Docs/Types/]group{!!group}] +[sort[description]]'>
<option value={{!!name}}><$view field='description'><$view field='title'/></$view> (<$view field='name'/>)</option>
</$list>
</optgroup>
</$list>
</$select>Este es su aspecto:
Multiple Selections
This example uses the multiple keyword to specify that we should be able to select multiple items.
<$select tiddler='$:/generated-list-demo-state' field='testing' multiple size='8'>
<$list filter='[tag[TableOfContents]]'>
<option><$view field='title'/></option>
</$list>
</$select><br />
<$list filter='[list[$:/generated-list-demo-state!!testing]]'>
<$view field='title' /><br />
</$list>
Este es su aspecto:
| purpose | returns each item in the list with the first letter capitalised |
|---|---|
| input | a selection of titles |
| output | the input titles with each first letter capitalised |
[[abc def ghi jkl]sentencecase[]]
[[abc deF gHi jKL]sentencecase[]]
[[abc deF gHi jKL]lowercase[]sentencecase[]]
[tag[HelloThere]sentencecase[]]
Note that the --server command is now deprecated in favour of the new ListenCommand.
See WebServer for details of TiddlyWiki's web server functionality.
El servidor compilado para TiddlyWiki5 es muy simple. Aunque es compatible con TiddlyWeb, no soporta muchas de las características necesarias para un uso robusto en Internet.
En la raíz, sirve un tiddler específico
Fuera de la raíz, sirve tiddlers individuales codificados en JSON, y soporta operaciones básicas HTTP de GET, PUT y DELETE.
--server <port> <roottiddler> <rendertype> <servetype> <username> <password> <host> <pathprefix>Los parámetros son
- port - número de puerto desde el que sirve (por defecto, "8080")
- roottiddler - tiddler que se sirve desde la raíz (por defecto, "$:/core/save/all")
- rendertype - tipo de contenido con el que se genera el tiddler raíz (por defecto "text/plain")
- servetype - tipo de contenido con el que se sirve el tiddler raíz (por defecto "text/html")
- username - nombre de usuario por defecto que firma la edición
- password - contraseña opcional para autenticación básica
- host - nombre opcional del servidor desde el que se sirve (por defecto, "127.0.0.1" o "localhost")
- pathprefix - prefijo opcional para rutas
Si se ha definido contraseña, el navegador pedirá que se introduzca nombre y contraseña.
Nótese que la contraseña se transmite en modo texto por lo que esta implementación no es apropiada para uso general.
Por ejemplo:
--server 8080 $:/core/save/all text/plain text/html MyUserName passw0rdEl nombre de usuario y la contraseña pueden ser especificados como cadenas de símbolos vacías si se necesita configurar el nombre del servidor o prefijo de ruta y no se requiere contraseña:
--server 8080 $:/core/save/all text/plain text/html "" "" 192.168.0.245Para ejecutar simultáneamente múltiples servidores TiddlyWiki, deberán configurarse cada uno en un puerto diferente
Termux is an open source Android application that combines a Linux system and a terminal.
Once you open Termux on your Android system, it is straightforward to install and run the Node.js flavour of TiddlyWiki from the command line.
From then on, as long as Termux is not closed, you may access your wiki anytime from your favourite Web browser pointing on the expected address and port.
note to contributors: in Termux, you may as well install git, emacs or vi, in order to edit and maintain individual tiddler files. This would probably require that you also attach a more powerful keyboard to your Android, like the Hacker's Keyboard application or a Bluetooth external device.
Téngase en cuenta que este comando es experimental y puede cambiar o ser reemplazado
Configura el campo especificado de un grupo de tiddlers como resultado de una plantilla con la variable currentTiddler
--setfield <filter> <fieldname> <templatetitle> <rendertype>Sus parámetros son:
- filter - filtro que identifica los tiddlers que se verán afectados
- fieldname - el campo que será modificado (por defecto, "text")
- templatetitle - el tiddler a wikify en el campo especificado. Si se deja en blanco o está ausente, el campo especificado es borrado.
- rendertype - el tipo de texto a generar (por defecto, "text/plain"; se puede usar también "text/html" para incluir etiquetas HTML)
El "favicon" es un pequeño icono que la mayoría de navegadores incorporan a la ventana para ayudar al usuario a identificar páginas.
favicons en el navegador
Cuando TiddlyWiki arranca en el navegador, busca un tiddler llamado $:/favicon.ico y lo usa dinámicamente como favicon de la página. Si modificas la imagen, el favicon cambiará al instante.
favicons en el servidor
Trabajando en la versión servidor de TiddlyWiki, es el comando ServerCommand quien facilita el contenido del tiddler $:/favicon.ico a la ruta /favicon.ico.
- Importa la imagen como un tiddler. Consulta Images in WikiText
- También pueden usarse imágenes externas
- Abre el Panel de control y la pestaña Theme Tweaks en Aspecto
- Selecciona la imagen en el desplegable "Page background image"
- Establece "Page background image attachment" como "Fixed to window" para mantener la imagen fija y que el contenido se desplace sobre ella o como "Scroll with tiddlers" para que se muevan simultáneamente.
- iPhone/iPad no soporta el ajuste como imagen fija, por razones de rendimiento
- Ajusta el tamaño de la imagen con "Page background image size":
- "Auto" hace que la imagen, si es necesario, forme mosaico para cubrir el fondo de la página
- "Cover" ajusta la imagen de forma que cubra por completo el fondo de la página, lo que puede provocar que zonas de la imagen queden fuera de la vista.
- "Contain" hace que la imagen cambie su tamaño para ajustarse a los bordes de la página, lo que puede producir deformaciones en la imagen según sean sus dimensiones (p.ej, una imagen cuadrada se estirará horizontalmente de forma desproporcionada a su altura para encajar en una pantalla rectangular panorámica)
De forma complementaria, puede ser necesario cambiar la Paleta de colores para mantener el nivel de legibilidad de la barra lateral.
Introduction
The set variable widget assigns a value to a specified variable. The new value of the variable is available to the content within the set variable widget.
Content and Attributes
The content of the <$set> widget is the scope for the value assigned to the variable.
| Attribute | Description |
|---|---|
| name | The name of the variable to assign (defaults to "currentTiddler") |
| value | The value to assign to the variable if the filter is missing or not empty |
| tiddler | New in: 5.1.15 Optional title of the tiddler from which to read the value |
| subtiddler | New in: 5.1.16 Optionally specifies the title of a subtiddler within a plugin tiddler identified by the tiddler attribute |
| field | New in: 5.1.15 Optional field of the tiddler from which to read the value (only used if tiddler is used) |
| index | New in: 5.1.15 Optional index of the tiddler from which to read the value (only used if tiddler is used) |
| filter | An optional filter to be evaluated and assigned to the variable (see below) |
| select | New in: 5.1.14 An optional zero-based index of the item to return from the filter output (see below) |
| emptyValue | The value to assign to the variable if the specified value is missing or empty (see below) |
Simple Variable Assignment
The simplest way of using set variable widget assigns a string to a variable. The following example assigns a literal string
<$set name="myVariable" value="Some text">
<$text text=<<myVariable>>/>
</$set>Both the name and value attributes can be transcluded. For example:
<$set name=<<anotherVariable>> value={{template!!text}}>
<$text text=<<myVariable>>/>
</$set>Conditional Variable Assignment
This form of the set variable widget chooses one of two specified values according to whether a filter evaluates to an empty list. Here's an example that sets a variable according to whether the current tiddler is called "myMagicTitle":
<$set name="myVariable" filter="[all[current]field:title[myMagicTitle]]" value="It's magic" emptyValue="It's not magic">
<$text text=<<myVariable>>/>
</$set>Filtered List Variable Assignment
This form of the set variable widget evaluates the filter and assigns the result to the variable as a space-separated list (using double square brackets for titles containing spaces).
<$set name="myVariable" filter="[tag[HelloThere]]">
<$text text=<<myVariable>>/>
</$set>Filtered Item Variable Assignment
New in: 5.1.14 This form of the set variable widget evaluates the filter and assigns the specified result to the variable as a single item (ie, not using double square brackets for titles containing spaces).
<$set name="myVariable" filter="[tag[HelloThere]]" select="0">
<$text text=<<myVariable>>/>
</$set>Transcluded Variable Assignment
New in: 5.1.15 This form of the set variable widget obtains the value to assign to the variable from a value in a tiddler field or index. For example:
<$set name="myVariable" tiddler="HelloThere" field="text">
<$text text=<<myVariable>>/>
</$set>The example above could also be written as <$set name="myVariable" value={{HelloThere!!text}}>. The advantage of using the tiddler attribute is that the tiddler title and field or index can themselves be computed. For example:
<$set name="myVariable" tiddler=<<myTiddler>> field={{$:/currentField}}>
<$text text=<<myVariable>>/>
</$set>| purpose | select the plugin titles that contain the input shadows |
|---|---|
| input | a selection of shadow titles |
| parameter | none |
| output | the plugins that contain the input tiddlers |
Each input title is processed in turn. If it denotes a shadow tiddler, the title of its plugin tiddler is dominantly appended to the output. Non-shadow tiddlers contribute nothing to the output.
[[$:/core/copyright.txt]shadowsource[]]
$:/core/copyright.txt $:/plugins/tiddlywiki/railroad/parser.js +[shadowsource[]]
ShadowTiddlers are tiddlers that are loaded from within Plugins. Unlike ordinary tiddlers, they don't appear in most lists.
ShadowTiddlers can be overridden with an ordinary tiddler of the same name. If that tiddler is subsequently deleted then the original shadow tiddler is automatically restored.
The current shadow tiddlers are:
Puedes trabajar en un TiddlyWiki en Dropbox y publicar una URL que cualquiera puede ver en vista de sólo lectura.
- Guarda el TiddlyWiki en tu carpeta de Dropbox
- Selecciona la opción de Dropbox Copiar enlace de Dropbox para tener una URL pública del archivo
- En el sitio web de Dropbox se hace haciendo clic sobre el botón Compartir que aparece al pasar el ratón por encima del archivo. Además de obtener el enlace público al documento (cualquiera que tenga el enlace podrá verlo), puedes decidir limitar qué usuarios tienen acceso al documento, o ponerle caducidad al enlace. Dropbox también añade la opción de copiar el enlace público al menú contextual (clic con el botón derecho sobre el archivo) en sus ediciones de escritorio para OS X, Windows y Linux.
La URL generada por Dropbox tiene este formato:
https://www.dropbox.com/s/<blablablaincomprensible>/mi_archivo.html - Cuidadosamente modifica la URL, conservando el blablablaincomprensible, así:
https://dl.dropboxusercontent.com/s/<blablablaincomprensible>/mi_archivo.html
El resultado es una URL "secreta" que puedes enviar a otros para que vean el documento.
Nota: Si compartes la URL sin modificar, aquel que la reciba verá el archivo en la interfaz online de Dropbox, no verá el archivo abierto.
Para ayudarte a modificar la URL pública de dropbox, cópiala aquí y así obtendrás la nueva URL secreta:
https://dl.dropboxusercontent.com/s/<blablabla>/mi_archivo.html (abrir)
Hay muchas formas de compartir tiddlers:
- Puedes enviar un ~Tiddlywiki por mail.
- Puedes publicarlo online y enviar un enlace...
- Puedes robar tiddlers de un TiddlyWiki que alguien haya publicado por ahí y, simplemente, importarlos al tuyo, arrastrándolos con el ratón:
- Abre tu TiddlyWiki en el navegador, en otra pestaña o en una nueva ventana.
- Busca un enlace al tiddler que te interesa
- Haz clic con el botón izquierdo del ratón y mantenlo presionado
- Arrastra el enlace a la ventana o pestaña en la que tienes tu TiddlyWIki hasta que aparezca una barra en la parte superior de la pantalla que indica que tu TiddlyWiki está listo para recibirlo.
- Al soltar el botón, aparecerá un tiddler pidiéndote que confirmes la importación.*
- Puedes compartirlo en Dropbox
- Puedes exportar tiddlers a una gran variedad de formatos: HTML estático, CSV...
| purpose | return -1, 0 or +1 for a list of numbers according to whether each number is negative, zero, or positive |
|---|---|
| input | a selection of titles |
| output | replaces each input number with -1, 0 or +1 according to whether the number is negative, zero, or positive |
New in: 5.1.20 See Mathematics Operators for an overview.
Crea un pull request en GitHub para añadir tu nombre a cla-individual.md o cla-entity.md, según corresponda si eres persona física o fiscal, con la fecha en formato YYYY/MM/DD.
paso a paso
- Según seas persona física o fiscal, ve a
- Haz clic en el botón Edit arriba a la derecha (al hacerlo se creará un fork del repositorio para que puedas editar el archivo)
- Añade tu nombre al final del documento
- P. Ej.:
Jeremy Ruston, @Jermolene, 2011/11/22
- P. Ej.:
- Bajo el cuadro de edición del documento, debieras ver otro más pequeño, con el título Propose file change
- Escribe un título que explique de qué cambio se trata (p. ej.: "signing the CLA")
- Haz clic en el botón verde que dice Propose file change
- En la página siguiente, haz clic en el botón verde que dice Create pull request
Sometimes you want to protect individual tiddlers from accidental changes, either from yourself or guests to your TiddlyWiki file. Here's a couple simple approaches. Note that these do not provide hardened protection against a wilful attack.
Using a stylesheet to lock tiddlers by tag name
Create a tiddler with the following contents and tag it as $:/tags/Stylesheet :
.tc-tagged-Locked button[title="Edit this tiddler"] {display: none;}
If your TW language isn't English, then you'll need to change the text in 'title="...."' to whatever the text is when you hover over the edit button.
Now any tiddler you tag as "Locked" will have the edit button hidden. To get it back you will need to open the stylesheet tiddler and change "none" to "inline".
Using transclusion to hide your tiddler in a system tiddler
- Open your tiddler for editing.
- Select the title and copy.
- Select all the tiddler text.
- Click on the excise tool.
- In the title box, type
$:/and then paste the original title. - Use the defaults to excise and and leave a transclusion
Now you can view the contents of your original tiddler, but to edit them your will have to find the the tiddler with the $:/ prefix.
Juego sencillo, construido en TiddlyWiki, presentado en A simple game built with TiddlyWiki, presentado en este post.
http://zorklike.tiddlyspot.com
Quise ver si era posible hacer algún tipo de juego usando sólo el núcleo de TiddlyWiki, sin plugins ni JavaScript. Hice una versión muy esquemática de juego de ficción al estilo de Zork. Es lo más sencillo que se puede hacer y que se pueda llamar juego, pero puede que le añada cosas más adelante. Lo hice en la versión 5.1.5 prerelease, porque el widget action-setfield ahorra mucho tiempo de definir macros.
Una de las finalidades es no usar nada más que lo que contiene el núcleo de TiddlyWiki, tal cual: sin usar JavaScript ni plugin alguno.
Una aplicación de archivo único es una en la que todos sus recursos se presentan en un único archivo estático. Esto significa que puede descargarse y usarse offline sin perder funcionalidad. Del mismo modo puede alojarse en casi cualquier tipo de servidor web.
TiddlyWiki es un caso particular de aplicación de archivo único porque guarda sus datos en sí mismo y es capaz, además, de guardar cambios en sí mismo, lo que también lo convierte en un curioso caso de quine con aplicaciones prácticas.
Por definición, una aplicación de archivo único lo es también de página única, pero lo contrario no siempre es del todo cierto.
Tal como lo define WIkipedia, una aplicación de página única es una que cabe en una sola página con el propósito de dar una experiencia más fluida a los usuarios, que carga dinámicamente contenido adicional a medida que el usuario navega por el sitio.
Es frecuente que las aplicaciones de página única se diseñen cuidadosamente para ocultar su naturaleza, de modo que su apariencia y funcionamiento sea la de una página estática común, respetando la barra de dirección y los controles de navegación adelante y atrás.
De manera inusual, TiddlyWiki es también una aplicación de archivo único.
- Tomar notas y usar etiquetas y enlaces para formar relaciones entre ellas
- Organizarte usando pestañas, solapas, tablas, listas e índices
- Organizar tus páginas web favoritas, como en este ejemplo
- Llevar el control de tareas y reuniones y organizarlos con múltiples etiquetas (mira nuestro sencillo ejemplo de administrador de tareas
- Hacer inventario de absolutamente todo: de tus recetas, tu biblioteca, tus contactos, tu colección de música ...etc.
- Crear un blog o página web personal
- Escribir un libro
- Organizar tus imágenes en galerías (mira un sencillo ejemplo de hoja de contactos
- Compartir con otros la información de tu TiddlyWiki, bien como archivo publicado online, como adjunto en un correo, como documento de tiddler individual o como enlace a un tiddler específico publicado online. Intenta arrastrar un tiddler de un TiddlyWiki a otro y verás qué ocurre)
- Bocetar sobre una imagen (edita Motovun Jack.jpg y dibuja con el ratón sobre la imagen para ver qué pasa)
- Usar elementos web habituales, como las llamadas lightboxes. (MIra un ejemplo pulsando el botón que aparece en SampleWizard)
- Crear una presentación de diapositivas
- Preparar toda una base de conocimientos, local u online con un archivo TiddlyWiki que enlace a otros. Aquí hay un ejemplo en castellano
- Preparar una presentación visual de datos, usando tiddlers como fuente de datos. Un buen ejemplo lo tienes en esta página
| purpose | sort the input by text field |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as text |
! output | the input, likewise sorted into descending order |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]sort[]]
[list[Days of the Week]!sort[]]
one two Three four +[sort[]]
[prefix[Tiddl]sort[text]]
[has[created]sort[created]limit[10]]
| purpose | sort the input by text field considering them as alphanumerics |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as alphanumerics |
! output | the input, likewise sorted into descending order |
The difference between uppercase and lowercase letters is ignored.
These examples make use of the Apple tiddler.
[list[Apple]sortan[]]
[list[Apple]!sortan[]]
App-10-A App-9-B App-10-B App-9-A +[sortan[]]
| purpose | sort the current list in the order of the list referenced in the operand |
|---|---|
| input | a list of items |
| parameter | order = a list specifying the order in which to sort the current list |
| output | all items sorted by lookup list |
These examples make use of the Days of the Week tiddler.
10 6 4 9 3 2 8 +[sortby[1 2 3 4 5 6 7 8 9 10]]
Friday Tuesday Monday Thursday Sunday +[sortby{Days of the Week!!list}]
1 Mon 5 Fri 4 Tue Sun 2 +[sortby{Days of the Week!!short}]
| purpose | sort the input by text field, treating upper and lower case as different |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as text |
! output | the input, likewise sorted into descending order |
These examples make use of the Days of the Week tiddler.
one two Three four +[sortcs[]]
one two Three four +[!sortcs[]]
Al ser de origen británico, TiddlyWiki prefiere, para su documentación en inglés, el uso ortográfico británico frente al americano .
Por ese motivo, palabras como "colour" siguen la norma británica, salvo en aquellos casos en que por motivos técnicos es obligado el uso de la norma americana (p.ej., código en CSS o JavaScript).
En esta edición en castellano, nos remitimos al uso ortográfico y estilístico peninsular, a la vez que invitamos a los usuarios hispanohablantes del resto de países a contribuir con este proyecto aportando el material que consideren necesario para que TiddlyWiki y su documentación se adapte a la rica variedad de dialectos de nuestra lengua.
Fuera de eso, los acrónimos técnicos estándar se escriben en mayúscula y sin puntos: "HTML"
Conviene evitar abreviar arbitrariamente palabras y frases, aunque las siguientes son aceptables:
| Abreviatura | Significado | Observaciones |
|---|---|---|
| p.ej. | por ejemplo | punto detrás de cada letra, aunque le sigan coma o dos puntos |
| i.e. | esto es, es decir, | punto detrás de cada letra |
| ...etc | etcétera | puntos suspensivos delante y sin punto detrás |
| purpose | returns each item in the list split into separate strings according to the specified separator S; duplicates are not removed |
|---|---|
| input | a selection of titles |
| parameter | S = The substring at which to split each title |
| output | the input titles split into separate items according to the specified separator S |
New in: 5.1.20
Note that in some circumstances the split operator will include blank items in the list of results. For example,
[[the band thethe are the best the]split[the]]The following results are returned:
["", " band ", "", " are ", " best ", ""]Where it might be expected that the results would be:
[" band ", " are ", " best "]The blank items mark the boundaries between matches. If they are not required they can be removed with the blank category of the is Operator: [[the band thethe are the best the]split[the]!is[blank]].
The reason that the blank items can be useful is that they allow search and replace operations to be constructed from a combination of the split Operator or splitregexp Operator and the join Operator. For example:
[[the band thethe are the best the]split[the]join[every]]
| purpose | select a delimited prefix from each input title |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters marking the end of the prefix |
| output | the prefix, up to and including S, of each input title |
Each input title is processed in turn.
- A title that contains
Scontributes everything up to and includingS. - A title that doesn't contain
Ssimply contributes itself to the output.
Contributions are dominantly appended to the output.
The table-of-contents macros use this operator with / as the parameter.
2015-01-26 2014-07-19 2013 +[splitbefore[-]]
[[green trees]splitbefore[ee]]
| purpose | returns each item in the list split into separate strings according to the specified regular expression R |
|---|---|
| input | a selection of titles |
| suffix | flags: m for multiline mode, i for case-insensitive mode |
| parameter | R = The regular expression at which to split each title |
| output | the input titles split into separate items according to the specified regular expression R |
New in: 5.1.20
Note that in some circumstances the splitregexp operator will include blank items in the list of results. For example,
[[the band thethe are the best the]splitregexp[the]]The following results are returned:
["", " band ", "", " are ", " best ", ""]Where it might be expected that the results would be:
[" band ", " are ", " best "]The blank items mark the boundaries between matches. If they are not required they can be removed with the blank category of the is Operator: [[the band thethe are the best the]splitregexp[the]!is[blank]].
The reason that the blank items can be useful is that they allow search and replace operations to be constructed from a combination of the split Operator or splitregexp Operator and the join Operator. For example:
[[nobody, really; wants; to see -- all this \punctuation]splitregexp[,|;|-|\\]join[...]]
Syntax errors in the regular expression will cause the filter to return an error message. For example:
[[the cat sat on the mat]splitregexp[\]]
The Stanford Javascript Crypto Library is a project by the Stanford Computer Security Lab to build a secure, powerful, fast, small, easy-to-use, cross-browser library for cryptography in Javascript.
TiddlyWiki executes any ActionWidgets found in tiddlers with the following system tags during startup:
- (executed on all platforms)
- (only executed when running in the browser)
- (only executed when running under Node.js)
Startup actions are useful for customising TiddlyWiki according to environmental factors such as the screen size. For example, the following action widgets when placed in a tiddler tagged $:/tags/StartupAction/Browser will cause the sidebar to be hidden by default when the screen width is less than 1000 pixels:
<$reveal type="lt" state="$:/info/browser/screen/width" text="3000">
<$action-setfield $tiddler="$:/state/sidebar" $value="no"/>
</$reveal>
<$reveal type="gteq" state="$:/info/browser/screen/width" text="3000">
<$action-setfield $tiddler="$:/state/sidebar" $value="yes"/>
</$reveal>New in: 5.1.20 This example switches to the language plugin matching the language reported by the browser:
<$action-setfield $tiddler="$:/language" text={{{ [[$:/languages/en-GB]] [plugin-type[language]sort[description]removeprefix[$:/languages/]] +[prefix{$:/info/browser/language}] ~[[en-GB]] +[addprefix[$:/languages/]] }}}/>Note that global macros are not available within startup action tiddlers by default. If you need to access them then you'll need to explicitly include them with an import pragma at the top of the tiddler:
\import [[$:/core/ui/PageMacros]] [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of]]The StateMechanism in TiddlyWiki is at the heart of how complex user interfaces can be built from WikiText.
In the browser, the TiddlyWiki display is produced by dynamically rendering the tiddler $:/core/ui/PageTemplate. Through various transclusions and other widgets it renders the entire user interface. The dynamic rendering is accomplished by a mechanism called "binding": any changes to the tiddlers in the store are dynamically reflected in the browser display.
The stack of templates that make up the TiddlyWiki display are complex but we'll focus on the line that displays the main story column:
<$list filter="[list[$:/StoryList]]" history="$:/HistoryList" template="$:/core/ui/ViewTemplate" editTemplate="$:/core/ui/EditTemplate" storyview={{$:/view}} />Breaking down the attributes applied to the list widget:
- filter: selects the list of tiddlers in the
listfield of the tiddler $:/StoryList. If a tiddler is added or removed from that list then it is automatically reflected in the displayed list - history: references the tiddler to be used to store the history stack (see the NavigationMechanism)
- template: identifies a template tiddler to be used for rendering each tiddler in the list
- editTemplate: identifies a different template tiddler to be used for rendering tiddlers that are in draft mode
- storyview: specifies the story view to be used (eg classic, or zoomin)
The $:/StoryList tiddler is an example of a StateTiddler: a tiddler that is used to hold the state of the user interface. Changes to the user interface are made indirectly, by changing the underlying state tiddlers, and letting TiddlyWiki ripple the changes through the user interface.
Note how this approach makes the open tab in the sidebar very easy to implement: it is just another list widget referencing the same state tiddler, but with a different template:
<$list filter="[list[$:/StoryList]]" history="$:/HistoryList" storyview="pop">
<$button message="tm-close-tiddler" class="tc-btn-invisible tc-btn-mini">×</$button> <$link to={{!!title}}><$view field="title"/></$link>
</$list>Now consider the implementation of the info panel within the tiddler template. We want to be able to toggle the info panel open and closed, which means that we must track its current state in a tiddler.
However, we can't track the state in a tiddler called, say, $:/InfoPanelState because every tiddler would share the same state; changing the value of the tiddler would affect all tiddlers displayed in the story.
The solution is to dynamically generate a unique title for each state tiddler that we need. We need to ensure that the same state tiddler title is generated each time a user interface element is rendered. To do that, we append together tokens representating each of the stack of transclusions that led to the current rendering location. Then that string of symbols is hashed to a simple numeric value.
The process of generating a state tiddler title is encapsulated in the qualify macro.
The "story river" (sometimes abbreviated to "story") is the sequence of tiddlers in the main column of the display.
When a tiddler is viewed or edited, then within its branch of the widget tree, the storyTiddler variable contains the title of that tiddler.
The default view template and edit template initialise storyTiddler to the value of the currentTiddler variable. This in turn will have been set by a $list widget in the relevant part of the page template.
storyTiddler is undefined outside the story river, such as in the sidebar.
<ol>
<$list filter="[prefix[J]]">
<li><<currentTiddler>>, <<storyTiddler>></li>
</$list>
</ol>| purpose | select the names of all the story views |
|---|---|
| input | ignored |
| parameter | none |
| output | the name of each story view |
| purpose | apply JavaScript string encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with JavaScript string encodings applied |
The following substitutions are made:
| Character | Replacement |
|---|---|
\ | \\ |
" | \" |
\r (carriage return) | \\r |
\n (line feed) | \\n |
\x08 (backspace) | \\b |
\x0c (form feed) | \\f |
\t (tab) | \\t |
| Characters from 0x00 to 0x1f and characters from 0x80 to 0xffff | \\u#### where #### is four hex digits |
Also see the jsonstringify Operator.
[[Title with "double quotes" and single ' and \backslash]] +[stringify[]]
TiddlyWiki5 proporciona varias herramientas útiles para estructurar información en forma de tiddlers y estructurar las diferentes relaciones que se establecen entre ellos:
You can use this construction to cause the wrapped content to be assigned specified CSS classes or styles:
@@.myStyle
* List One
* List Two
@@
Tiene este aspecto:
- List One
- List Two
... y su código HTML es:
<ul class="myStyle"><li>List One</li><li>List Two</li></ul>
Similar syntax is used to assign styles. For example:
@@background-color:red;
* List One
* List Two
@@
Tiene este aspecto:
- List One
- List Two
... y su código HTML es:
<ul style="background-color:red;"><li>List One</li><li>List Two</li></ul>
Multiple styles and classes can be mixed. For example:
@@.tc-tiddler-frame
@@width:400px;
Some text
@@
Tiene este aspecto:
Some text
... y su código HTML es:
<p class="tc-tiddler-frame" style="width:400px;">Some text </p>
The following core macros make it easy to specify alternative browser-specific properties when constructing a stylesheet tiddler:
<<box-shadow shadow>>- for the
x-box-shadowproperties <<filter filter>>- for the
x-filterproperties <<transition transition>>- for the
x-transitionproperties <<transform-origin origin>>- for the
x-transition-originproperties <<background-linear-gradient gradient>>- for the
x-linear-gradientvalues of thebackground-imageproperty
The following macros are documented separately:
All these macros are defined in the $:/core/macros/CSS tiddler.
| purpose | select titles from the operand interpreted as a filter expression |
|---|---|
| input | a selection of titles passed as input to the subfilter |
! input | a selection of titles passed as input to the subfilter |
| parameter | S = a filter expression |
| output | the selection of titles returned from the subfilter S |
! output | those input titles that are not returned from the subfilter S |
New in: 5.1.18 Note that the subfilter operator was introduced in version 5.1.18 and is not available in earlier versions.
<$set name="myFilter" value="[tag[one]]">
<$list filter="[all[tiddlers]subfilter<myFilter>]">
...| purpose | select all fields present in the selected tiddlers within a plugin |
|---|---|
| input | a selection of tiddler titles |
| parameter | P = the title of a plugin |
| output | all field names present in the selected tiddlers within the plugin named P |
| purpose | treating each input title as a number, subtract from each the numeric value of the operand |
|---|---|
| input | a selection of titles |
| parameter | N = a number |
| output | the input as numbers, but with N subtracted from each one |
New in: 5.1.20 See Mathematics Operators for an overview.
| purpose | filter the input titles by how they end |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | those input titles that end with S |
! output | those input tiddlers that do not end with S |
In looking for matches for S, capital and lowercase letters are treated as different.
| purpose | produce the sum of the input numbers |
|---|---|
| input | a selection of titles |
| output | the result of adding together the input as numbers |
New in: 5.1.20 See Mathematics Operators for an overview.
The system tag $:/tags/KeyboardShortcut defines the tagged Tiddler as a Keyboard Shortcut Tiddler, a container for actions that get triggered when its corresponding Keyboard Shortcut Descriptor in its key field matches a keyboard combination executed by the User
The system tag $:/tags/RawMarkup marks plain text tiddlers to be included as raw markup at the bottom of the <head> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect.
The system tag $:/tags/RawMarkupWikified marks wikified tiddlers to be included as raw markup at the bottom of the <head> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
New in: 5.1.18 The system tag $:/tags/RawMarkupWikified/BottomBody marks wikified tiddlers to be included as raw markup at the bottom of the <body> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
New in: 5.1.18 The system tag $:/tags/RawMarkupWikified/TopBody marks wikified tiddlers to be included as raw markup at the top of the <body> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
New in: 5.1.18 The system tag $:/tags/RawMarkupWikified/TopHead marks wikified tiddlers to be included as raw markup at the top of the <head> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
The system tag $:/tags/SideBarSegment marks sidebar segments
Note: You can rearrange the segments by drag-and-dropping the titles inside the tag pill
The system tag $:/tags/StartupAction/Browser marks actions only executed when running in the browser
System tags are used to give special behaviour to tiddlers.
These are the system tags defined by the TiddlyWiki core:
System tags defined by TiddlyWiki plugins
| can be seen at: tiddlywiki prerelease see: top left page control bubble | |
| help panel "videos" tab | |
| can be seen at: tiddlywiki prerelease. see: Tiddler toolbar | |
| used by the translators edition | |
| twitter plugin | |
| see: tiddlywiki prerelease | |
| tiddlywiki test suite |
Tiddlers are classified as system tiddlers if their title starts with the special string $:/. The only difference from ordinary tiddlers is that they are hidden from most searches and lists in the sidebar. (In particular, system tiddlers are shown in the "More/System" list).
System tiddlers provide a simple way to hide the internal components of TiddlyWiki so that they don't clutter things up, getting in the way of the users content.
Many of the system tiddlers follow the convention of using further slashes to delineate the components of the title. For example: $:/config/BitmapEditor/LineWidth.
You don't need to create your own system tiddlers, but it can be useful when customising TiddlyWiki. For example, if you create a custom palette you might call it $:/_MyPalette so that (a) it is hidden from searches/lists and (b) it will appear at the top of the system tiddler list for easy reference.
TiddlyWiki provides several macros for generating a tree of tiddler links by analysing tags:
toc- A simple tree
toc-expandable- A tree in which all the branches can be expanded and collapsed
toc-selective-expandable- A tree in which the non-empty branches can be expanded and collapsed
toc-tabbed-internal-navandtoc-tabbed-external-nav- A two-panel browser:
- on the left, a selectively expandable tree that behaves like a set of vertical tabs
- on the right, the content of whichever tiddler the user selects in the tree
The difference between the last two has to do with what happens when the user clicks a link in the right-hand panel:
toc-tabbed-internal-nav- The target tiddler appears in the right-hand panel, replacing the tiddler that contained the link
toc-tabbed-external-nav- The target tiddler appears in the normal way (which depends on the user's configured storyview)
Structure
The top level of the tree consists of the tiddlers that carry a particular tag, known as the root tag. Tiddlers tagged with any of those make up the next level down, and so on.
At each level, the tiddlers can be ordered by means of the list field of the parent tag tiddler. They can also be ordered by the macro's sort parameter.
The tree displays the caption field of a tiddler if it has one, or the tiddler's title otherwise.
Each tiddler in the tree is normally displayed as a link. To suppress this, give the tiddler a toc-link field with the the value no. In the examples, the SecondThree tiddler is set up like this. Clicking such a tiddler in the tree causes its branch to expand or collapse.
The table of contents is generated as an HTML ordered list. The <ol> elements always have the class tc-toc. Expandable trees have the additional class tc-toc-expandable. Selectively expandable trees (including those in the two-panel browser) have tc-toc-selective-expandable.
To make a table of contents appear in the sidebar, see How to add a new tab to the sidebar.
Parameters
- tag
- The root tag that identifies the top level of the tree
- sort
- An optional extra filter step, e.g.
sort[title]
These two parameters are combined into a single filter expression like this:
[tag[$tag$]$sort$]
toc-tabbed-internal-nav and toc-tabbed-external-nav take additional parameters:
- selectedTiddler
- The title of the state tiddler for noting the currently selected tiddler, defaulting to
$:/temp/toc/selectedTiddler. It is recommended that this be a system tiddler - unselectedText
- The text to display when no tiddler is selected in the tree
- missingText
- The text to display if the selected tiddler doesn't exist
- template
- Optionally, the title of a tiddler to use as a template for transcluding the selected tiddler into the right-hand panel
These examples derive tables of contents from the root tag Contents. See Table-of-Contents Macros for details on how to use the Table-of-Contents Macros to make your own structured table-of-contents.
You can explore the same structure with these clickable tag pills:
The tabbed example uses the real TableOfContents of this documentation instead.
<div class="tc-table-of-contents">
<<toc "Contents">>
</div>Basics
TiddlyWiki5 formats tables using vertical bar characters like so:
|!Cell1 |!Cell2 |
|Cell3 |Cell3 |Exclamation marks are used to indicate header cells. The example renders as:
| Cell1 | Cell2 |
|---|---|
| Cell3 | Cell3 |
Cell Alignment
Table cell alignment is controlled by inserting space characters before and/or after the cell content. For example:
|Left aligned content |
| Right aligned content|
| Centred content |
|+++ a very wide column so we can see the alignment +++|The example renders as:
| Left aligned content |
| Right aligned content |
| Centred content |
| +++ a very wide column so we can see the alignment +++ |
Cell vertical Alignment
Vertical alignment of cells is done by inserting either a ^ for top alignment or a , for bottom alignment as the first character of a cell. The normal horizontal alignment is still possible. For example:
|^top left |^ top center |^ top right|
|middle left | middle center | middle right|
|,bottom left |, bottom center |, bottom right|The example renders as:
| :: | ::::::::::::::::::::::::::: | ::::::::::::::::::::::::::: | ::::::::::::::::::::::::::: | :: |
| :: :: | top left | top center | top right | :: :: |
| :: :: | middle left | middle center | middle right | :: :: |
| :: :: | bottom left | bottom center | bottom right | :: :: |
| :: | ::::::::::::::::::::::::::: | ::::::::::::::::::::::::::: | ::::::::::::::::::::::::::: | :: |
If you need to have a ^or a , as the first character of a left aligned cell, you can use HTML escaping:
^ | ^ |
, | , |
Cell Merging
To merge a table cell with the one above, use the special cell text ~. To merge a cell with the one to its left use the text <. To merge one to its right use >. For example:
|Cell1 |Cell2 |Cell3 |Cell4 |
|Cell5 |Cell6 |Cell7 |<|
|Cell5 |~|Cell7 |Cell8 |
|>|Cell9 |Cell10 |Cell11 |Renders as:
| Cell1 | Cell2 | Cell3 | Cell4 |
| Cell5 | Cell6 | Cell7 | |
| Cell5 | Cell7 | Cell8 | |
| Cell9 | Cell10 | Cell11 | |
Table Classes, Captions, Headers and Footers
Table CSS classes, captions, headers and footers can be specified as special pseudo-rows. The following example:
- assigns the CSS classes "myclass" and "anotherClass" to the table
- gives the table the caption "This is a caption"
- adds a header row of cells with the text "Header"
- adds a footer row of cells with the text "Footer"
|myclass anotherClass|k
|This is a caption |c
|Cell1 |Cell2 |
|Cell3 |Cell3 |
|Header|Header|h
|Footer|Footer|fRenders as:
| Cell1 | Cell2 |
| Cell3 | Cell3 |
| Header | Header |
| Footer | Footer |
The tabs macro presents a selection of tiddlers as a set of tabs that the user can switch between.
The tabs display the caption field of a tiddler if it has one, or the tiddler's title otherwise. If specified, the tabs display the tooltip field of a tiddler as the respective button tooltip.
By default the tabs are arranged horizontally above the content. To get vertical tabs, set the class parameter to tc-vertical.
Parameters
- tabsList
- A filter selecting which tiddlers to include
- default
- The title of the tiddler whose tab is to be selected by default
- state
- The prefix for the title of a state tiddler for noting the currently selected tab, defaulting to
$:/state/tab. It is recommended that this be a system tiddler - class
- Additional CSS classes for the generated
divelements. Multiple classes can be separated with spaces - template
- Optionally, the title of a tiddler to use as a template for transcluding the content of the selected tab
- buttonTemplate
- Optionally, the title of a tiddler to use as a template for transcluding the content of the button for the selected tab
- retain
- Optionally, "yes" specifies that the content of the tabs should be retained when switching to another tab, avoiding re-rendering it (this can be useful to avoid video or audio sources unexpectedly resetting)
Within the template, the title of the selected tab is available in the currentTab variable.
The currentTiddler variable is not affected by the tabs macro. This can put you in trouble if the list of tabs includes tiddlers that depend on the value of the currentTiddler, for example tiddlers listing children based on its own name. To overcome this problem you can use a TemplateTiddler like the following:
<$tiddler tiddler=<<currentTab>>>
<$transclude mode="block" />
</$tiddler><<tabs "SampleTabOne SampleTabTwo SampleTabThree SampleTabFour" "SampleTabOne" "$:/state/tab1">><<tabs "[tag[sampletab]]" "SampleTabTwo" "$:/state/tab2" "tc-vertical">><<tabs "[tag[sampletab]nsort[order]]" "SampleTabThree" "$:/state/tab3" "tc-vertical">>The tag macro generates a tag pill for a specified tag.
Parameters
- tag
- The title of the tag, defaulting to the current tiddler
| purpose | filter the input by tag |
|---|---|
| input | a selection of titles |
| suffix | S = New in: 5.1.14 optional strict flag |
| parameter | T = the title of a tag |
| output | those input tiddlers that have tag T |
! output | those input tiddlers that do not have tag T |
The output is sorted using the tag's list field and the tiddlers' list-before and list-after fields.
The behaviour when T is empty depends on the settings of the S optional suffix:
- if
Tis missing andSis either missing or set to "loose", then the output oftagis empty, and the output of!tagis a copy of the input. - New in: 5.1.14 if
Tis missing andSis set to "strict", then the output of bothtagand!tagis a copy of the input
[tag[task]]
[tag[task]!tag[done]]
[!tag[task]]
[all[shadows]tag[$:/tags/Stylesheet]]
The tag-pill macro generates a static tag pill showing a specified tag, but without the dropdown action provided by the tag Macro.
Parameters
- tag
- The title of the tag
- element-tag
- The element name to be used for the pill (defaults to "span")
- element-attributes
- Additional attributes for the pill element
- actions
- Action widgets to be triggered when the pill is clicked. Within the text, the macro parameter tag contains the title of the selected tag.
Poner etiquetas es una forma de organizar tiddlers en categorías.
Por ejemplo, si tuvieras una serie de tiddlers que representa a un grupo de gente que conoces, podrías etiquetarlos como amigo, familiar, colega...etc, para indicar tu relación con ellos.
Una etiqueta es, de hecho, un tiddler (o un tiddler en potencia) y también puede tener sus propias etiquetas. Además puedes añadir cualquier número de etiquetas a un mismo tiddler.
En Crear y editar tiddlers te decimos cómo etiquetar tiddlers.
Al etiquetar tiddlers, puedes ver, buscar y organizar la información de múltiples maneras:
- Haciendo clic en las píldoras de colores de un tiddler tienes acceso inmediato a cualquiera de los tiddlers que tienen misma etiqueta, así como al tiddler que representa esa etiqueta y que contiene, en forma de índice, una lista de todos esos tiddlers etiquetados igual.
- Si un tiddler sirve como etiqueta, la pestaña Etiquetado en el InfoPanel te mostrará qué tiddlers son los que llevan el título de ese tiddler como etiqueta.
- La pestaña Más de la barra lateral presenta una vista general, organizada por solapas, que te permite acceder a todos los tiddlers etiquetados.
- Puedes usar filtros para crear listas de tiddlers basadas en sus etiquetas. Puedes mostrar cualquier combinación de campos de esos tiddlers. Por ejemplo, puedes confeccionar un glosario haciendo una lista de los campos "título" y "texto" de todos los tiddlers con la etiqueta "Glosario". Tales listas pueden formatearse como prefieras con viñetas, números, o separadas por comas.
- Hay un número de etiquetas especiales de sistema que controlan tanto el layout de los tiddlers, como el de toda la página. Más información en Diseño de tiddlers y de página
Hay un par más de cosas que se pueden hacer con etiquetas:
Ponerles color e icono
Se puede usar el gestor de etiquetas de la pestaña Más de la barra lateral para cambiarles el color o para añadirles un icono.
- Para cambiar el color, haz clic en el botón de la columna Color y selecciona uno nuevo en la rueda. También puedes hacer clic en el icono de la columna Información e introducir un valor CSS en el campo Color
- Para añadir un icono a la etiqueta, haz clic en el botón de la columna Icono y selecciona uno de entre los disponibles. También, si sabes el nombre del tiddler que contiene el icono que quieres usar, puedes introducirlo directamente en el campo correspondiente de la columna Información
- To change the icon, click the button in the Icon column and choose from the list of available icons
Cambiar el orden de etiquetado
Por defecto, los tiddlers se muestran en orden alfabético.
Si quieres cambiarlo, añade el campo list al tiddler y como valor enumera los tiddlers según el orden que quieras que tengan en la lista.
El campo list no necesita enumerarlos a todos. En Orden de los tiddlers etiquetados se especifican más concretamente las reglas que sigue TiddlyWiki para ordenarlos.
| purpose | find the tiddlers that have the input tags |
|---|---|
| input | a selection of tags |
| parameter | none |
| output | the titles of any tiddlers that carry the input tags |
Each input tag is processed in turn. The list of tiddlers carrying that tag is generated, sorted, and then dominantly appended to the operator's overall output.
[[task]tagging[]]
[tag[task]]Concepts task +[tagging[]]
[all[current]tagging[]]
| purpose | select all tags of the input tiddlers |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | all the tags carried by the input tiddlers |
Each input title is processed in turn. The corresponding tiddler's tags are retrieved (in order of appearance in the tags field) and then dominantly appended to the operator's output.
Un TagTiddler o "tiddler etiqueta" es un tiddler cuyo título se usa para etiquetar a otros.
La pestaña Etiquetado del InfoPanel muestra qué tiddlers usan el título del actual como etiqueta.
Se pueden usar etiquetas sin correspondencia con un TagTiddler.
TiddlyWiki5 sirve también como sencillo sistema de administración de tareas, sin necesidad de mayores complicaciones. La idea consiste en etiquetar las tareas como task, de modo que una vez hechas se etiqueten también como done. Así resulta bastante sencillo generar listas de tareas.
Aquí tienes un ejemplo:
Tareas pendientes
Tareas completadas
This is a version of the TaskManagementDemo enhanced with the ability to drag and drop the task list to re-order them.
Outstanding tasks
Drag the tasks to re-order them
Completed tasks
(Listed in reverse order of completion)
Al redactar material didáctico, empieza por planificar la información que quieres presentar como un itinerario: debe ser una progresión sencilla, lógica y directa de ideas, sin retrocesos ni saltos. Aplica este enfoque incluso en frases sueltas, de modo que el discurso vaya de la causa al efecto y de lo viejo conocido a lo nuevo desconocido.
Usa frases cortas y sencillas. Una frase en estilo técnico y claro raramente contiene más de una idea, por eso se evita el uso de paréntesis. De igual manera, haz que la estructura de los párrafos sea sencilla. Una presentación lisa y llana suele ser más fácil de comprender que una una exposición jerarquizada de conceptos.
A menudo se puede simplificar una frase sin necesidad de cambiar su significado, tanto como para ajustar su vocabulario o estructura gramatical. "Se realiza la ejecución de la macro" sólo significa "Macro en ejecución". "Tus expectativas podrían ser..." es lo mismo que "puedes esperar que...".
Usa preferentemente la voz activa: "Fulano crea un tiddler" es mejor que "un tiddler es creado por Fulano" o "se crea un tiddler por Fulano". El uso de oraciones pasivas o impersonales puede ser útil cuando se quiere que el lector se centre en una acción o en su resultado: "se crea un tiddler", pero en general es más claro partir de una causa y explicar su efecto y decir algo del estilo de "esta acción crea un tiddler", de la forma más natural y sencilla posible.
En la documentación generalmente se presentan conceptos paralelos, bien por su parecido, bien por su diferencia. Al lector puede serle más fácil comprenderlo si se usan las mismas frases o la misma estructura de exposición, pero debe de hacerse de manera equilibrada para que no resulte monótono.
Son preferibles las instrucciones claras y precisas a una larga e intrincada explicación. Si algo tiene nombre, úsalo. Si no lo tiene, ponlo en un tiddler.
A template tiddler is not actually a type of tiddler, it is a role in which a tiddler can be used.
Templates are a way to re-use chunks of WikiText.
Transcluding through a template extends the basic functionality of Transclusion by combining two tiddlers:
- A template tiddler that contains the WikiText to be displayed. It can contain transclusions that reference fields in the current tiddler
- A target tiddler that identifies which tiddler is to be treated as current when resolving references to fields
The best example of templating is the main story river in TiddlyWiki. Each tiddler in the story river is rendered through a ViewTemplate that specifies how each field is to be rendered.
See Transclusion with Templates for details.
- Con TiddlyWiki puedes organizar tus notas a tu manera, no a la suya. Tus notas se adaptan a tu forma de pensar, en lugar de ponerte un corsé estructurado jerárquicamente en cuadernos y pestañas
- El enfoque no linear deTiddlyWiki's te hará ver tu información de formas nuevas y más útiles
- Encontrar tus notas en TiddlyWiki es cosa de un segundo
- Hay muchas maneras de personalizar y adaptar cada aspecto de TiddlyWiki
- TiddlyWiki es libre y gratuito y es compatible, además, con cualquier plataforma. Funciona en cualquier navegador web y no necesitas comprar ningún programa ni pagar suscripción alguna para usarlo como se te antoje.
- TiddlyWiki promueve el libre intercambio de información. Hay muchas formas de compartir información en TiddlyWiki
- Con TiddlyWiki, tu información es tuya y sólo tuya y puedes guardarla donde te dé la gana: en el ordenador, en el móvil, en la tablet, en un pendrive, en Dropbox, en un servidor... Tú mandas.
- TiddlyWiki cuenta con un número creciente de plugins, temas, widgets e idiomas en permanente desarrollo
- La comunidad TiddlyWiki es amable y hará siempre lo que pueda para proporcionarte la ayuda que necesitas
- Si además eres programador, encontrarás incluso más formas de jugar con TiddlyWiki, porque cuanto más aprendes de TiddlyWiki, más te diviertes con él.
El Cortatextos es una edición especial que contiene herramientas para dividir largos textos en tiddlers individuales.
A TextReference is a general purpose way to describe a fragment of text as either a field of a tiddler, or an index within a data tiddler.
In different situations, text references can be used to retrieve values, or to specify a value that should be modified.
A TextReference consists of several parts:
- The title of the target tiddler. If omitted, it defaults to the Current Tiddler
- Either one of:
- The name of a field (marked with
!!) - The name of an index within a data tiddler (marked with
##)
- The name of a field (marked with
- If both the field and index are omitted, the text field is used as the default
Most of the parts of a text reference can be optional:
tiddlerTitle- the title field of the specified tiddlertiddlerTitle!!field- a tiddler field (eg,modified,modifier,typeetc)!!field- a field of the current tiddlertiddlerTitle##propertyIndex- extracts a named property from DataTiddlers
Text references can be used in several places:
- As indirect parameters within Filters (eg,
<$list filter="[tag{MyTag!!name}]"/>) - As indirect attributes of an element or widget (eg,
<$widget attrib={{Title!!description}}/>) - As the operand of a shortcut transclusion (eg,
{{MyTiddler!!title}}) - As the
stateattribute of the RevealWidget and the LinkCatcherWidget
Introduction
The text widget displays plain text without parsing it as WikiText, opposite of WikifyWidget.
Content and Attributes
The content of the <$text> widget is not used.
| Attribute | Description |
|---|---|
| text | The text to display |
Example
<$vars string="//italic//">
* <<string>>
* <$text text=<<string>>/>
</$vars>
Este es su aspecto:
- italic
- //italic//
The text-test field of this tiddler has a field value: <$text text={{!!text-test}}/>
It displays in its normal WikiText format as: {{!!text-test}}
Este es su aspecto:
The text-test field of this tiddler has a field value: e=mc^^2^^
It displays in its normal WikiText format as: e=mc2
Introduction
A number of extended filters are necessary to manipulate lists.
The first set of filters are designed to move items from the tail of the list and insert them at specified locations in the list. Items are often appended to the list before using these filters. In general, these filters accept a suffix specifying the number of items to move (default to 1.)
A second set of filters are designed to either add or remove from the list, a selected range of items from an array. These filters are best used with a reference to an array, stored in a field or data index elsewhere in the wiki (they may be used with a simple list of items, provided the items do not include white space.) In general, these filters accept a suffix specifying the number of items to move (default to All.)
Examples
In this example we shall populate the 'DataIndex' index of the tiddler 'MyData' with the names of the days of the week, then clear this list.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[list[Days of the Week]]"/>
Get days-of-the-week
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[[]]"/>
Clear
</$button>
{{ListopsData}}Este es su aspecto:
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to insert items before and after a marker item (Wednesday) that are first appended to the list.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="one two +[putbefore:2[Wednesday]]"/>
Put 2 Items Before Wednesday
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="four five +[putafter:2[Wednesday]] three +[putbefore[Wednesday]]"/>
Put One Item Before & Two Items After Wednesday
</$button>
{{ListopsData}}Este es su aspecto:
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to replace the marker item (Wednesday) with items which are first appended to the list. We shall then move 3 items to the head of the list which have first been appended to the list from referenced fields.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="[[---o]] [[o---]] +[replace:2{!!marker}]"/>
Replace '!!marker' with 2 Items
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="[{!!item1}] [{!!item2}] [{!!item3}] +[putfirst:3[]]"/>
Put 3 Items First
</$button>
{{ListopsData}}Este es su aspecto:
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to append to the truncated list, items from a referenced field. We shall then remove the first two of the items added.
|list: |<$view field="list"/> |
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[allbefore:include[Wednesday]] +[prepend{!!list}]"/>
Prepend '!!list' to items before 'Wednesday'
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[remove:2{!!list}]"/>
Remove first two items in '!!list' from current list
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[!remove:1{!!list}]"/>
Remove last item in '!!list' from current list
</$button>
{{ListopsData}}Este es su aspecto:
| list: | Yesterday Today Tomorrow |
DataIndex:
In this example we shall populate the list with numbers, then move items one by one from the head to the tail and from the tail to the head (best seen by clicking the lower buttons several times.)
This example illustrates that the append[] and prepend[] operators do not enforce unique instances of an item and that, with the next run, any duplicates are removed.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[[]]" $subfilter="+[append:3{!!numbers}]"/>
Setup some numbers
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[!append:6{!!numbers}]"/>
Append more numbers
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[putfirst:2[]]"/>
Move last 2 items to the head
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[putlast[]]"/>
Move the head to the last item
</$button>
{{ListopsData}}Este es su aspecto:
DataIndex:
Historias de terror
Cada tanto se cuentan en los grupos de discusión historias que parten el corazón sobre usuarios que por uno u otro motivo han perdido los datos guardados en TiddlyWiki:
Mi TiddlyWiki acaba de ser borrado por completo durante un cuelgue de Firefox cuando guardaba...
https://groups.google.com/d/topic/tiddlywiki/oG2L7OXhUoI/discussion
La última vez que lo usé fue anoche, en casa, en mi ordenador con Windows 7. Le di a para guardar la última entrada y se guardó via TiddlyFox. Expulsé el USB, llegué al trabajo esta mañana, enchufé el USB, metí la contraseña y, como se negaba a abrir, después de varios intentos busqué el archivo html de TW5. Fue entonces cuando me di cuenta de que el tamaño del archivo ya no es de 3Mb, sino de 80Kb. Me parece que lo he perdido todo.
https://groups.google.com/d/topic/tiddlywiki/SXStDJ0ntGI/discussion
¡Que no te pase a ti!!
La primera regla de uso de TiddlyWiki es:
¡¡Haz copia de seguridad!!
TiddlyWiki es un sistema altamente flexible y customizable que te pone firmemente a cargo de tus datos. En el desarrollo de TiddlyWiki se pone todo el cuidado posible para garantizar que es un lugar seguro donde guardar tus datos más preciados. Sin embargo y en última instancia, la responsibilidad de reducir el riesgo de pérdida de datos recae sobre sus usuarios.
La mejor manera de asegurarse de que tus datos están seguros es mediante un riguroso sistema de "backup" o copia de seguridad.
- Usa servicios del estilo de Dropbox para tener siempre una copia de seguridad online. Dropbox tiene además una característica especial, que guarda y permite recuperar versiones anteriores de un archivo.
- Haz copia de seguridad antes de actualizar TiddlyWiki a una nueva versión
- Piensa siempre en cómo protegerte en el peor de los casos: ¿qué pasa si falla el USB o se rompe el disco duro? ¿Qué pasa si el ordenador se bloquea por un virus?
- Actúa de manera defensiva y redundante: haz varias copias de seguridad y mantenlas en distintos sitios
| purpose | replace input titles by a constant string |
|---|---|
| input | a selection of titles |
| parameter | T = a string |
| output | the input titles with each one replaced by the string T |
New in: 5.1.20 See Conditional Operators for an overview.
[[HelloThereMissing]is[missing]then[yes]]
[[HelloThere]is[missing]then[yes]]
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
This is an example tiddler. See Table-of-Contents Macros (Examples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Examples
Here is an example of the thumbnail-right macro used to create a video thumbnail that floats to the right of the text
<<thumbnail-right link:"Introduction Video" image:"Introduction Video Thumbnail.jpg" caption:"Introduction to ~TiddlyWiki" icon:"{{$:/core/images/video}}" color:"red">>
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.This example tiddler is used to illustrate some of the Filter Operators.
before and after
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]before{!!title}]
[list[Days of the Week]after{!!title}]
Conforme a nuestra filosofía, los tiddlers de la documentación son breves y están interrelacionados.
Cuando parece que un tiddler necesita subapartardos, es señal de que quizá convendría dividirlo en tiddlers más pequeños. Es razonable, sin embargo, que un tiddler de referencia vaya encabezado por una sección introductoria general, seguido de una serie de secciones.
Coherencia terminológica es esencial para no confundir al lector.
Consistencia tipográfica y de puntuación dan calidad profesional a la documentación. El uso de macros se recomienda por razones de consistencia del texto y de mantenimiento de futuras revisiones.
Se aconseja el uso de listas numeradas para intrucciones paso-a-paso y el de viñetas para listas cuyo orden es arbitrario. Se prefiere el uso de listas de definición sobre el de listas con viñetas si cada elemento de la lista comienza con un término y dos puntos. En la medida de lo posible conviene evitar niveles excesivos de anidamiento de listas.
Conviene usar tablas cuando la información encaja naturalmente en tres o cuatro columnas y para listas de parámetros, atributos... etc
La documentación describe la realidad actual de TiddlyWiki y debe evitarse discutir futuras aspiraciones del proyecto.
Muchos tiddlers de la documentación, especialmente los de referencia, hacen referencia a un único concepto. Sus títulos debieran ser sintagmas nominales simples y claros como List Widget, TiddlerFields o Material de referencia.
En la edición original inglesa, cada sustantivo del título se escribe con mayúscula, mientras que artículos, preposiciones y conjunciones se escriben con minúscula. Ej:Ejemplo de Título de la Edición en Inglés
En la presente edición en castellano, sólo lleva mayúscula la palabra inicial del título y el resto se escribe en minúscula y termina sin punto: Ejemplo de título de la edición en castellano
Las etiquetas siguen también este mismo patrón.
Los títulos de este tipo son en plural si se refieren a una categoría de elementos: —Ej: Atajos de teclado—, ya que etiquetan tiddlers más específicos dentro de su categoría.
Cuando el objeto del título sea un concepto más que una categoría, se enuncia en singular. Ej:List Widget, Operador de etiqueta
En la edición inglesa, los títulos comienzan enunciando su parte más distintiva. Por ejemplo, los tiddlers que documentan operadores de filtro tienen títulos del estilo addprefix Operator. De este modo, en teoría, el lector puede identificar rápidamente un tiddler particular en una lista de enlaces.
En la presente edición en castellano, sin embargo y por coherencia gramatical, los títulos se enuncian en el orden lógico y acostumbrado en nuestra lengua. El ejemplo anterior sería, por tanto: Operador addprefix. Nótese, sin embargo, lo siguiente:
- Con el fin de mantener la integridad del código de TiddlyWiki y las referencias de su documentación, así como de facilitar futuras actualizaciones, estamos obligados a dejar los títulos de de la documentación original en inglés sin traducir. Esto, que podría ser un inconveniente, nos da la ventaja de poder explotar las funcionalidades de TiddlyWiki y así ofrecer al lector un doble juego de títulos para cada tiddler:
- Un título completo, que es el que corresponde a la traducción del título original, que se muestra en el encabezamiento de cada tiddler (en el presente:
Estilo de los títulos) - Un título abreviado, que es una descripción esquemática del contenido del tiddler, lo que resulta útil para identificar un tiddler en particular en una lista de enlaces o en el índice de la barra lateral (en el presente:
Estilo: Títulos)
- Un título completo, que es el que corresponde a la traducción del título original, que se muestra en el encabezamiento de cada tiddler (en el presente:
Al redactar material de referencia debe evitarse que el título comience con artículo y en general debe evitarse el abuso de determinantes.
En anteriores ediciones, muchos títulos se escribían en CamelCase. Para hacerlos más legibles, se ha ido abandonando gradualmente esta práctica y se desaconseja su uso, salvo en casos como TiddlyWiki o JavaScript, ya que tal es su forma estándar.
TiddlerFields are name:value pairs that make up a tiddler. Field names must be lowercase letters, digits or the characters - (dash), _ (underscore) and . (period).
The standard fields are:
| Field Name | Reference | Description |
|---|---|---|
title | TitleField | Nombre único de un tiddler |
text | TextField | Texto principal de un tiddler |
modified | ModifiedField | Fecha y hora de última modificación |
modifier | ModifierField | Nombre del tiddler asociado con quien modificó por última vez el presente tiddler |
created | CreatedField | Fecha de creación del tiddler |
creator | CreatorField | Nombre del autor del tiddler |
tags | TagsField | Lista de etiquetas asignadas al tiddler |
type | TypeField | Tipo de contenido en un tiddler |
list | ListField | Lista ordenada de tiddlers asociados al presente tiddler |
caption | CaptionField | Texto que se muestra en una pestaña o botón, con independencia del título del tiddler que lo define |
Other fields used by the core are:
| Field Name | Reference | Description |
|---|---|---|
class | ClassField | |
color | ColorField | Valor CSS del color de fondo asociado a un tiddler |
description | DescriptionField | Descripción de un complemento, extensión, o diálogo modal |
draft.of | DraftOfField | Título del tiddler del que el actual es borrador |
draft.title | DraftTitleField | Nuevo título propuesto para el presente borrador |
footer | FooterField | Texto al pie que figurará en un asistente |
hide-body | HideBodyField | The view template will hide bodies of tiddlers if set to: yes |
icon | IconField | Nombre del tiddler que contiene el icono que se quiere asociar al presente tiddler |
library | LibraryField | Si su valor es "Sí", indica que el tiddler debe guardarse como librería de JavaScript |
list-after | ListAfterField | Título del tiddler tras el que el presente será añadido a una lista de tiddlers. |
list-before | ListBeforeField | Título del tiddler antes del que el presente será añadido a una lista |
name | NameField | Nombre asociado con un complemento o extensión |
plugin-priority | PluginPriorityField | Valor numérico que indica la prioridad de un complemento o extensión |
plugin-type | PluginTypeField | Tipo de complemento o extensión |
source | SourceField | Dirección de la fuente asociada a un tiddler |
subtitle | SubtitleField | Subtítulo que figurará en un asistente |
toc-link | TocLink | Suppresses the tiddler's link in a Table of Contents tree if set to: no |
The TiddlyWebAdaptor uses a few more fields:
| Field Name | Reference | Description |
|---|---|---|
bag | BagField | Nombre de la bolsa de la que procede un tiddler |
revision | RevisionField | Revisión del tiddler existente en el servidor |
Details of the fields used in this TiddlyWiki are shown in the control panel under the Información tab >> Avanzado sub-tab >> Tiddler Fields
Tiddlers can be stored in text files in several different formats. Files containing single tiddlers can also have an auxiliary .meta file formatted as a sequence of name:value pairs:
title: TheTitle
modifier: someoneTiddlyWeb-style .tid files
These files consist of a sequence of lines containing name:value pairs, a blank line and then the text of the tiddler. For example:
title: MyTiddler
modifier: Jeremy
This is the text of my tiddler.Note that many text editors require that files include a terminating newline. If you want to avoid including the terminating newline in the text of the tiddler you can use this alternative syntax:
title: MyTiddler
modifier: Jeremy
text: This is the text of my tiddler.The ContentType application/x-tiddler is used internally for these files
TiddlyWiki <DIV> .tiddler files
In TiddlyWiki 5, *.tiddler files look like this:
<div title="AnotherExampleStyleSheet" modifier="blaine" created="201102111106" modified="201102111310" tags="examples" creator="psd">
<pre>Note that there is an embedded <pre> tag, and line feeds are not escaped.
And, weirdly, there is no HTML encoding of the body.</pre>
</div>These *.tiddler files are not exactly the same as the tiddlers inside a TiddlyWiki HTML file where they are HTML encoded.
Older *.tiddler files more closely matched the store format used by TiddlyWiki at the time:
<div tiddler="AnotherExampleStyleSheet" modifier="JeremyRuston" modified="200508181432" created="200508181432" tags="examples">This is an old-school .tiddler file, without an embedded <pre> tag.\nNote how the body is "HTML encoded" and new lines are escaped to \\n</div>The ContentType application/x-tiddler-html-div is used internally for these files
TiddlyWeb-style JSON files
These files are a straightforward array of hashmaps of name:value properties. All field values must be specified as strings.
For example:
[
{
"title": "First Tiddler",
"text": "Text of first tiddler",
"tags": "one two [[t h r e e]]"
},{
"title": "Second Tiddler",
"text": "Text of second tiddler",
"modified": "20150216171751154"
}
]The ContentType application/json is used internally for these files.
Note that JSON files that do not conform to the tiddler structure will instead be imported as a single tiddler containing the JSON data.
TiddlyWiki HTML files
TiddlyWiki HTML files contain a collection of tiddlers encoded in <DIV> format.
For TiddlyWiki to import an unencrypted HTML file, it requires a <div id="storeArea"> containing tiddler DIVs as explained above. For example:
<div id="storeArea">
<div created="20130302085406905" modified="20130302084548184" tags="Examples" title="A tiddler title">
<pre>HTML encoded text of tiddler
</pre>
</div>
<div created="20140315085406905" modified="20140321084548184" tags="One Two [[Three with Space]]" title="Another title" customfield="field value">
<pre>Text of this tiddler
</pre>
</div>
</div>Un enlace es la región de un tiddler sobre la que se puede hacer clic para navegar a otro. El comportamiento de navegación lo determina el StoryView actual. La vista "classic" muestra la historia como una secuencia lineal de tiddlers.
Si se mantiene pulsada la tecla Ctrl o command al hacer clic en un enlace, se abre el tiddler de destino, pero no se navega hasta él. Esta es una forma muy útil de poner en cola una serie de tiddlers para su lectura.
Los enlaces o links son útiles para modelar relaciones orgánicas entre tiddlers y, más particularmente, para iterar la navegación entre tiddlers.
El Panel de información muestra en la pestaña Referencias una lista de los links que llegan al tiddler.
En Filtros se pueden incluir los siguientes operadores para trabajar con enlaces:
[links[]]- devuelve el título de los tiddlers enlazados desde el tiddler o selección actual de tiddlers.[backlinks[]]- devuelve el título de los tiddlers que enlazan con el tiddler o selección actual de tiddlers.
TiddlyWiki5 modifica la apariencia de los enlaces para dar información adicional sobre el tipo de tiddler al que se enlaza:
| Descripción del link | Apariencia |
|---|---|
| A un tiddler existente | TalCual |
| A un tiddler que no existe (faltante) | TalCual |
| A un tiddler oculto que no ha sido anulado | TalCual |
| A un tiddler oculto que ha sido anulado por un tiddler común | TalCual |
Los enlaces externos se muestran así: https://tiddlywiki.com/ o así.
Los Tiddlers son las unidades fundamentales de información en TiddlyWiki.
Funcionan mejor cuanto más pequeños son, de modo que puedan entretejerse más fácilmente de las más diferentes formas posibles.
Otros sistemas tienen conceptos análogos con nombres genéricos como "items", "entradas", "entidades", "nodos" o "records". TiddlyWiki es de la opinión de que es preferible ser vagamente preciso a ser vagamente genérico; de ahí que nos guste «Tiddler», que en origen es una palabra coloquial inglesa, usada para referirse a un pez pequeño.
Internamente, los tiddlers se componen de una lista de valores únicos llamados campos. El único campo obligatorio es título, pero los tiddlers útiles tienen también un campo texto y todos o algunos de los campos estándar que se muestran en TiddlerFields.
En TiddlyWiki, los tiddlers están por todas partes. Sirven para guardarlo todo, desde módulos en código de JavaScript, a ajustes y configuraciones asociadas a la interfaz de usuario.
Introduction
The TiddlerWidget is used to set a value for the current tiddler variable, valid within the scope of the TiddlerWidget.
Content and Attributes
| Attribute | Description |
|---|---|
| tiddler | The title of the tiddler to become the new current tiddler |
CSS Class Variables
The tiddler widget assigns several useful CSS classes to variables that it creates:
- missingTiddlerClass
tc-tiddler-existsor...tc-tiddler-missingdepending on whether the tiddler exists- shadowTiddlerClass
tc-tiddler-shadowif the tiddler is a shadow tiddler- systemTiddlerClass
tc-tiddler-systemif the tiddler is a system tiddler- tiddlerTagClasses
- a space separated list of CSS classes named
tc-tagged-{tagname},
e.g.tc-tagged-introduction
Note: tag names are URI encoded which means that the tag $:/tags/Macro appears as the CSS classtc-tagged-%24%3A%2Ftags%2FMacro. See How to apply custom styles by tag for more details
You can use these variables like this:
<$tiddler tiddler="MyOtherTiddler">
<div class=<<missingTiddlerClass>>>
<$transclude/>
</div>
</$tiddler>See also $:/core/ui/ViewTemplate.
An extension application for Google Chrome that enables TiddlyWiki to save changes directly to the file system.
BuggyJay's TiddlyClip browser extension for Firefox permits clipping of text and graphics from web pages:
http://tiddlyclip.tiddlyspot.com
TiddlyClip allows parts of webpages to be clipped into a TiddlyWiki, and consists of two parts, the browser addon and the TiddlyWiki plugin. The addon is completely memoryless, any configuration is determined by the current TiddlyWiki that the user has select to work with (we say that the addon is docked to the TiddlyWiki). TiddlyClip is designed to work (in a basic mode) without configuration. Once the addon and plugin are installed, all the user has to do is select which TW to dock to.
TiddlyDesktop es una aplicación de escritorio para trabajar con archivos de TiddlyWikii, tanto del veterano TiddlyWiki Classic, como del nuevo TiddlyWiki5. Se puede instalar en ,Windows, Mac OS X o Linux.
Aquí hay un video de introducción a TiddlyDesktop
Instrucciones
- Descarga la última versión de TiddlyDesktop de https://github.com/Jermolene/TiddlyDesktop/releases
- Ejecuta TiddlyDesktop
- Usa el botón browse para abrir archivos de TiddlyWiki
- Guarda los cambios como habitualmente
Fuente
TiddlyDesktop se basa en NW.js, proyecto de código abierto y la fuente se encuentra en GitHub:
https://github.com/Jermolene/TiddlyDesktop/
Consulta las versiones de TiddlyDesktop
The latest release of TiddlyDesktop can be found at https://github.com/Jermolene/TiddlyDesktop/releases/latest, or you can see a list of all releases.
An add-on for Google Drive that allows TiddlyWiki files stored there to be opened and saved directly
To find out how to add it to your account, go to the project's info page: https://lordratte.gitlab.io/tiddlydrive/#installation-guide
I made an app that lets one edit TiddlyWiki files saved in your Google drive and then saving them back automagically. The page is here https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo but I think you need to add it from the Google Drive web interface.
I even added an optional ability to save with ctrl + s hotkeys.
Joshua's launch post
TiddlyFox is an extension for older versions of Firefox that allows standalone TiddlyWiki files to save their changes directly to the file system. TiddlyFox works on both desktop and smartphone versions of Firefox. See Saving with TiddlyFox or Saving with TiddlyFox on Android for detailed instructions.
TiddlyFox is now obsolete due to its incompatibility with the latest versions of Firefox - see Firefox Apocalypse. There are many alternatives to TiddlyFox, but none that work in precisely the same way – see GettingStarted for details.
TiddlyFox can be downloaded from the Mozilla Addons site:
https://addons.mozilla.org/en-GB/firefox/addon/tiddlyfox/
You can also install the latest development version of TiddlyFox direct from GitHub:
https://github.com/TiddlyWiki/TiddlyFox/raw/master/tiddlyfox.xpi
Summary
On 14th November 2017 Mozilla released Firefox 57, a major new version with many improvements and security enhancements. However, in amongst those improvements are some fundamental changes to Firefox's security model with the unfortunate effect of making it impossible for TiddlyFox to function.
TiddlyFox will remain available for people who continue to use older versions of Firefox, but anyone upgrading to the new version will need to choose a new way to handle saving changes with TiddlyWiki.
Happily, several new ways of working with TiddlyWiki now exist so that users have many alternative choices – see GettingStarted for details. The demise of TiddlyFox has provoked several of these recent developments and thus may well ultimately be good for the community.
There is a discussion thread on the TiddlyWiki forums about these developments.
Background
Firefox was first released in November 2004, a few months after the first version of TiddlyWiki. It was in many ways the Millenium Falcon to Microsoft's Death Star (in the shape of Internet Explorer). IE had by then enjoyed more than 5 years as the dominant browser, leading many in the web community to be frustrated that Microsoft's self-serving extensions to HTML had become de facto standards at the expense of innovation that might benefit the web community as a whole.
Firefox quickly became successful because it managed to render web pages with close enough compatibly with Internet Explorer while offering a superior user experience. A large part of the promise of that user experience was the ability for any user to customise every aspect of the browser. Two innovations were behind this:
- The entire user interface of the browser was constructed in XUL, effectively an extension of HTML that enabled it to render conventional user interfaces (at the time, HTML was largely restricted to simple document-oriented layouts). Tweaking a few lines of XUL code could make wholesale changes to the user interface of the browser
- The Mozilla add-on architecture gave full privileges to add-ons, enabling them to observe and interact deeply with the browser engine itself, and the file system of the computer on which it was running
These two conditions enabled a vibrant ecosystem of Firefox add-ons, many of them extremely popular. In many cases, innovations that were first seen in browser add-ons later became integrated into the browser itself, most notably the web debugger Firebug which was eventually cloned by all the browser manufacturers.
Firefox continued to be extremely popular until Google joined the development of the rival WebKit browser to make Chrome. Google took a very different approach to the trade offs of making a browser, focusing on improving security at the expense of almost all other considerations. They pioneered approaches such as isolating each tab in its own process that were quickly adopted by all other major browsers.
Google's approach precluded them adopting Mozilla's free-for-all approach to add-ons. Instead of having access to the entire browser environment and filing system, add-ons in Chrome see only a restricted subset of what is going on within the browser, and enjoy little or no access to the resources of the host machine.
It was inevitable that Mozilla would eventually adopt Google's approach to browser security vis-a-vis add-ons. There is a point at which it wouldn't be responsible for Mozilla to be releasing a browser that had knowingly worse security than the market leader.
Lessons
Some of the fecundity of the TiddlyWiki ecosystem stems from the adoption of the above two principles from Firefox:
- Making the application user interface out of the same primitives as the application content
- Giving add-ons free rein to observe and interact with all of the internal logic of the application
Those two characteristics present similar security challenges to TiddlyWiki as they did to Firefox. A TiddlyWiki that was primarily focused on security would need to curtail those abilities.
The Future
Innovation on new browser-based user interfaces and capabilities has now shifted from browser extensions to a new generation of frameworks that simplify creation of a custom browser based on an off-the-shelf open source HTML rendering engine. TiddlyDesktop uses nwjs, while Beaker Browser uses an alternative called Electron.
TiddlyIE is an extension for Internet Explorer that allows standalone TiddlyWiki files to save their changes directly to the file system. TiddlyIE works with the desktop version of Internet Explorer.
See Saving with TiddlyIE.
An interactive network visualisation plugin based on Vis.js. A demo that also contains installation instructions can be found here: http://tiddlymap.org. The plugin's GitHub repository can be found here.
TiddlyMap is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable graphs. By creating relations between your topics you can easily do the following:
- Create concept maps and quickly manifest your ideas in tiddlers.
- Create task-dependency graphs to organize and describe your tasks.
- Visualize your topic structures to get an immediate grasp of topics and relations.
In general you may create, visualize and describe any network-structure you have in mind.
An extension to the Node.js configuration of TiddlyWiki that adds support for static attachments and for working with multiple wikis at the same time.
https://github.com/Arlen22/TiddlyServer
TiddlyServer 2.0 takes the server command of TiddlyWiki on NodeJS and adds it to a static file server. This means you can load and serve any TiddlyWiki data folder in the same way you can serve a single file TiddlyWiki.
But you don't need to serve files and folders from just one place, you can serve them from multiple places anywhere on your harddrive (literally anywhere NodeJS can stat, readdir, and readFile). You can even organize them into virtual folders (aka aliases in Apache and mounts in Express).
The main point, of course, is that you can actually edit your files, not just look at them. Single file TiddlyWikis use the put saver, which needs to be patched using a bookmarklet included on the index page. The instructions for this are below under the heading "One thing that needs to be noted".
And, of course, you can edit data folder tiddlywikis just like you were running node tiddlywiki.js data –server, except that you run it on the path that you found it at (e.g. http://localhost/personal/notes/). You can have as many data folders open as you want, they don't conflict (though they will each take memory).
Data folders store individual tiddlers instead of entire wikis. They take less disk space as they also do not store the core and plugins. This means they also save much quicker, especially over the internet. They also save immediately (within 10 seconds or so) and they save drafts.
TiddlySpace es un entorno web para TiddlyWiki, construido desde TiddlyWeb.
TiddlySpace fue originalmente esponsorizado por Osmosoft en BT.
TiddlySpot es un servicio de alojamiento gratuito para documentos de TiddlyWiki hecho por Simon y Daniel Baird. La manera más sencilla de empezar a usarlo es registrarse en http://tiddlyspot.com. Por defecto muestra la última versión de TiddlyWiki Classic, pero es totalmente compatible con TW5
TiddlyWeb es una aplicación de servidor que publica Tiddlers en la web:
TiddlyWeb puede usarse para alojar wikis hechos en TiddlyWiki Classic y TiddlyWiki5, de modo que los tiddlers individuales estén disponibles en una API HTTP flexible.
TiddlyWeb fue originalmente esponsorizada por Osmosoft en BT, junto con TiddlySpace.
The web server API uses tiddlers in a special format originally designed for TiddlyWeb:
- Field values are represented as strings. Lists (like the tags and list fields) use double square brackets to quote values that contain spaces
- Tiddlers are represented as an object containing any of a fixed set of standard fields, with custom fields being relegated to a special property called fields
- The standard fields are: bag, created, creator, modified, modifier, permissions, recipe, revision, tags, text, title, type, uri
For example, consider the following tiddler:
{
"title": "HelloThere",
"tags": "FirstTag [[Second Tag]]",
"my-custom-field": "Field value"
}In transit over the API, the tiddler would be converted to the following format:
{
"title": "HelloThere",
"tags": "FirstTag [[Second Tag]]",
"fields": {
"my-custom-field": "Field value"
}
}TiddlyWiki es una potente herramienta interactiva para la manipulación de información compleja con estructura que no encaja fácilmente en las herramientas tradicionales, como hojas de cálculo o procesadores de texto.
TiddlyWiki está diseñado para adaptarse a tu forma de pensar y ayudarte a manejar todo aquello que no acaba de encajar. La idea fundamental es que la información es más útil y está más a mano si la dividimos en unidades mínimas, semánticamente significativas –tiddlers– y le damos títulos que permitan estructurarlas mediante enlaces, etiquetas, listas y macros.
Los tiddlers se valen de una notación especial que llamamos WikiText para explotar, de forma sencilla, una amplia variedad de opciones de formato de texto y enlace hipertextual. TiddlyWiki tiene como objetivo proporcionar una interfaz fluida de trabajo que permita agregar tiddlers y componer así narraciones más largas.
La gente adora TiddlyWIki. Primero, porque puede usarse tal cual, sin necesidad de complicadas infrastructuras de servidor y, porque al ser de código abierto, brinda una libertad sin precedentes para que cualquiera pueda mantener su información más preciada bajo su propio control.
TiddlyWiki fue creado originalmente por JeremyRuston y es en la actualidad un próspero proyecto open source, con una animada comunidad de desarrolladores independientes.
The first TiddlyWiki Camp Paris was held on Saturday 6th June 2015.
Bienvenue sur le site du TiddlyWiki Camp. Un évènement pour rencontrer la communauté de ce logiciel Open Source, libre et gratuit. Découvrez ce bloc note personnel polyvalent et adoptez-le pour gérer votre quotidien !
Originally built by Jeremy Ruston and now maintained by Arlen Beiler, TiddlyWiki Cloud (formerly known as TiddlyWiki in the Sky for Dropbox) is an online service that lets you edit TiddlyWiki documents directly in your own Dropbox using just a browser.
It works with TiddlyWiki 5 and Classic.
La comunidad TiddlyWiki mantiene reuniones periódicas online con Google Hangouts. Normalmente, los martes, de 17:00 a 19:00 hs (hora central europea).
De todos modos, se anuncian debidamente en el Grupo de TiddlyWiki y en la cuenta @TiddlyWiki de Twitter.
Los últimos Hangouts están archivados en este canal de YouTube:
TiddlyWiki in the Sky para TiddlyWeb permite sincronizar contenidos entre TiddlyWiki en el navegador y el servidor de TiddlyWeb (o TiddlySpace). Sus características incluyen:
- Carga diferida
- Sincronización de dos vías entre navegador y servidor
- La sincronización del servidor se realiza por "polling" (cada 60 segundos)
- "Throttling", para que los tiddlers que cambian rápidamente no saturen el servidor
Para probar TiddlyWiki in the Sky para TiddlyWeb:
- Crea, si es necesario, una cuenta en http://tiddlyspace.com/
- Crea un nuevo espacio
- Incluye el espacio
tw5tiddlyweb - Visita
http://<mi_espacio>.tiddlyspace.com/tw5
A catchy jingle for TiddlyWiki.
https://musescore.com/node/796056
Even if it sounds like some ol' jazz tune it IS an original composition and it should be quite obvious that the "hook of the melody" is a trill made by singing Tidd-ly Wiki :-).
My lacking skills for writing text/lyrics should be apparent in the fact that the text consists of 12 Tidd-ly Wikis and some extra "tiddly's" - just for the sake of getting the message delivered ;-)...
I've recorded every instrument on my guitar via a guitar synth on a loop machine (except for the drums - they were played live/in sync with the loop station on a "BeatBuddy" drum pedal..) - no pc was involved..
Este breve screencast muestra cómo configurar Firefox para Android para guardar cambios en TiddlyWiki:
Ejecutar TiddlyWiki en Node.js tiene una serie de importantes ventajas sobre la versión de archivo único:
- Puedes editar contenidos en cualquier navegador compatible con HTML5 browser, incluso en smartphones y tablets.
- Los tiddlers individuales se guardan como archivos separados, que puedes organizar a tu gusto
- Puedes construir múltiples wikis con diferentes combinaciones de contenido único y compartido
Para mayor información, consulta:
Here are the details of recent releases of TiddlyWiki5. See TiddlyWiki5 Versioning for details of how releases are named. Note that archived versions of release source files are available at https://github.com/Jermolene/TiddlyWiki5/releases
If you are using node.js, you can also install prior versions like this:
npm install -g tiddlywiki@5.1.13
(BetaReleases and AlphaReleases are listed separately).
Release 5.1.21
Released 10 septiembre 2019 at 15:23
See GitHub for detailed change history of this release
This is a bug fix release that resolves issues introduced in the recent Release 5.1.20.
Bug Fixes
- Fixed crash with ActionDeleteFieldWidget and a missing tiddler attribute
- Fixed edge cases where some tiddler lists were not valid when interpreted as a filter
- Fixed problem with too many alerts when upgrading a wiki containing an overwritten core module
- Reverted inadvertently switching on performance instrumentation
- Fixed bug with WikiText within field names
- Fixed problem with classes in the Table-of-Contents Macros
- Fixed missing foreground colour for buttons with class
tc-btn-invisible - Fixed whitespace around field editor inputs
- Fixed layout problems with the translators edition
- Fixed crash with the External Attachments Plugin on Windows
- Removed inconsistent shadow for tag pills in the sidebar
- Fixed regression with the field Operator and blank operands
- Reverted erroneous change in v5.1.20 in the way that lists are stringified
- Fixed the Open sidebar tab to use the
tv-story-listvariable - Fixed problem saving to GitLab
Node.js Bug Fixes
- Fixed bug with customised tiddler file naming
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
Exhaustiva y recomendada serie de tutoriales para empezar a moverte cómodamente con TiddlyWiki. https://www.youtube.com/playlist?list=PLzZCajspPU_UjFn0uy-J9URz0LP4zhxRK
Estos tutoriales están pensados para darte las nociones básicas que te permitan empezar de inmediato a usar TiddlyWiki. Echamos una rápida mirada a la tecnología detrás de TiddlyWiki y a cómo instalarlo y crear tu primer Tiddler.
Introduction
A tiddlywiki.files JSON file in a sub-folder within a TiddlyWiki folder overrides the usual logic for recursively scanning the folder for tiddler files. Instead, the tiddlywiki.files file specifies instructions for loading tiddlers from specific files and folders.
The format of the file is an object with two optional properties:
- tiddlers - an array of objects describing external files with the ability to override or modify any of the fields read from the file
- directories - an array of objects describing external directories, a filter determining which files within those directories should be processed, and the ability to override or modify any of the fields read from the file
Note that significant enhancements to tiddlywiki.files processing were introduced in Release 5.1.14.
Field overrides
Both the tiddlers and directories sections of tiddlywiki.files files include the ability to override or customise the values of fields with a fields object.
Each field can be specified as either a string or array value to be assigned directly to the field, or New in: 5.1.14 an object describing how to generate the value for the field. The object contains the following properties:
- source - (optional) a string specifying the source value for the field. If not specified, the existing value is used
- filename the filename of the file containing the tiddler
- filename-uri-decoded the filename of the file containing the tiddler, with URI decoding applied
- basename the filename of the file containing the tiddler without any extension
- basename-uri-decoded the filename of the file containing the tiddler without any extension, with URI decoding applied
- extname the extension of the filename of the file containing the tiddler
- created the creation date/time of the file containing the tiddler
- modified the modification date/time of the file containing the tiddler
- prefix - (optional) a string to be prepended to the value of the field
- suffix - (optional) a string to be appended to the value of the field
Tiddlers section
The file specifications in the tiddlers array support the following properties:
- file: (required) the absolute or relative path to the file containing the tiddler data (relative paths are interpreted relative to the path of the
tiddlywiki.filesfile) - isTiddlerFile: (optional) if
true, the file will be treated as a tiddler file and deserialised to extract the tiddlers. Otherwise, the raw content of the file is assigned to thetextfield without any parsing - fields: (optional) an object containing values that override or customise the fields provided in the tiddler file (see above)
- prefix & suffix: (optional) strings to be prefixed and suffixed to the tiddler
textfieldNote that providing a prefix here is equivalent to setting the
textfield of the fields object to{"prefix":"<prefixvalue>"}.
Directories section
Directory specifications in the directories array may take the following forms:
- a string literal, specifying the absolute or relative path to the directory containing the tiddler files (relative paths are interpreted relative to the path of the
tiddlywiki.filesfile). The directory is recursively searched for tiddler files - New in: 5.1.14 an object with the following properties:
- path - (required) the absolute or relative path to the directory containing the tiddler files (relative paths are interpreted relative to the path of the
tiddlywiki.filesfile). Note that the directory is not recursively searched; sub-directories are ignored - filesRegExp - (optional) a regular expression that matches the filenames of the files that should be processed within the directory
- isTiddlerFile - (required) if
true, the file will be treated as a tiddler file and deserialised to extract the tiddlers. Otherwise, the raw content of the file is assigned to thetextfield without any parsing - fields - (required) an object containing values that override or customise the fields provided in the tiddler file (see above)
- path - (required) the absolute or relative path to the directory containing the tiddler files (relative paths are interpreted relative to the path of the
Fields can be overridden for particular files by creating a file with the same name plus the suffix .meta – see TiddlerFiles.
Examples
These example tiddlywiki.files must be placed in their own sub-directory of the wiki folder.
There are also several examples of tiddlywiki.files files in the main TiddlyWiki 5 GitHub repository.
Importing a folder of PDFs
This example retrieves all the files with the extension .pdf from a folder specified by a relative path. Each tiddler is set up for LazyLoading with the following fields:
- title - set to the URI decoded base filename of the PDF file. URI decoding allows characters like "/" to be included in titles by URI encoding them as "%2F"
- created - set to the creation date/time of the PDF file
- modified - set to the modification date/time of the PDF file
- type - set to
application/pdf - tags - set to
$:/tags/AttachedFile - text - set to an empty string
- _canonical_uri - set to the string "pdfs/" concatenated with the filename
{
"directories": [
{
"path": "../../../input/pdfs",
"filesRegExp": "^.*\\.pdf$",
"isTiddlerFile": false,
"fields": {
"title": {"source": "basename-uri-decoded"},
"created": {"source": "created"},
"modified": {"source": "modified"},
"type": "application/pdf",
"tags": ["$:/tags/AttachedFile"],
"text": "",
"_canonical_uri": {"source": "filename", "prefix": "pdfs/"}
}
}
]
}TiddlyWikiFolders are configured with a single tiddlywiki.info file in the root of the wiki folder. It should contain a JSON object comprising the following properties:
- plugins - an array of plugin names to be included in the wiki
- themes - an array of theme names to be included in the wiki
- languages - an array of language names to be included in the wiki
- includeWikis - an array of references to external wiki folders to be included in the wiki
- build - a hashmap of named build targets, each defined by an array of command tokens (see BuildCommand)
- config - an optional hashmap of configuration options (see below)
includeWikis
The entries in the includeWikis array can be either a string specifying the relative path to the wiki, or an object with the following fields:
- path - relative path to wiki folder
- read-only - set true to prevent the tiddlers in the included wiki from being modified. The modifications will be written to the directory specified in default-tiddler-location, described below
build
Note that the build targets of included wikis are merged if a target of that name isn't defined in the current tiddlywiki.info file.
config
Configuration options include:
- default-tiddler-location - a string path to the default location for the filesystem adaptor to save new tiddlers (resolved relative to the wiki folder)
- retain-original-tiddler-path - If true, the server will generate a tiddler $:/config/OriginalTiddlerPaths containing the original file paths of each tiddler in the wiki
Example
For example:
{
"plugins": [
"tiddlywiki/tiddlyweb",
"tiddlywiki/filesystem"
],
"includeWikis": [
{"path": "../tw5.com", "read-only": true}
],
"build": {
"index": [
"--rendertiddler","$:/core/save/all","index.html","text/plain"],
"favicon": [
"--savetiddler","$:/favicon.ico","favicon.ico",
"--savetiddler","$:/green_favicon.ico","static/favicon.ico"]
},
"config": {
"retain-original-tiddler-path": true
}
}Building TiddlyWikiClassic
TiddlyWiki5 can be used to build older 2.x.x versions of TiddlyWikiClassic from their constituent components. Doing so involves these features:
- The
tiddlywiki/classictoolsplugin, containing a deserializer module which allows tiddlers to be loaded from TiddlyWiki 2.x.x.recipefiles - The
stripcommentsformat for the ViewWidget, which strips single line JavaScript comments starting//# - The
stripTitlePrefix='yes'attribute of the FieldsWidget, which removes prefixes wrapped in curly braces from thetitleattribute- For example,
{tiddler}HelloTherewould be transformed toHelloThere
- For example,
Usage
TiddlyWikiClassic is built from the command line by running TiddlyWiki on Node.js. A typical usage would be:
node ../../tiddlywiki.js \
--verbose \
--load <path_to_recipe_file> \
--rendertiddler $:/core/templates/tiddlywiki2.template.html <path_to_write_index_file> text/plain \
|| exit 1TiddlyWiki5 es la nueva reencarnación de TiddlyWiki para los próximos 25 años. Es un wiki completamente interactivo, escrito en JavaScript, que puedes ejecutar localmente en el navegador o en un servidor, mediante Node.js.
Each release of TiddlyWiki5 is identified by a version number that complies with the Semantic Versioning 2.0.0 standard.
TiddlyWiki Core Version
According to the standard:
Given a version number MAJOR.MINOR.PATCH, increment the:
MAJOR version when you make incompatible API changes,
MINOR version when you add functionality in a backwards-compatible manner, and
PATCH version when you make backwards-compatible bug fixes.
Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.Alpha and Beta versions
While in alpha TiddlyWiki5 uses the pre-release label "alpha", for example:
5.0.1-alphaEach new alpha or beta release will bump the PATCH version number. This breaks the strict semantics of versioning because PATCH increments are supposed to be reserved for compatible changes.
Note that prior to 5.0.1-alpha, TiddlyWiki5 used version numbers formatted as 5.0.0-alpha.19. The change was made to enable the upgrade mechanism to recognise plugin updates from the version information.
Interim versions
During development when a new release is being prepared, the pre-release label is set to prerelease.
Plugin Versions
Version numbers
TiddlyWiki5 uses the version information attached to plugins for determining which of two plugins is more recent during an upgrade or import. The pre-release label is ignored when performing these comparisons.
"TiddlyWiki Classic" se refiere a las versiones de TiddlyWiki anteriores a la 5.0, cuando se decidió reescribir TiddlyWiki por completo y empezando de cero.
TiddlyWiki Classic recibe aún mantenimiento y está disponible en:
https://classic.tiddlywiki.com/
Mario Pietsch ha publicado una página que compara la sintaxis y otras diferencias entre la versión Classic y la actual:
Node.js soporta, además de wikis de archivo único, wikis estructurados en carpetas que llamamos WikiFolders. Dichas carpetas contienen, lógicamente, tiddlers y las distinguimos según el tipo de tiddlers que contengan.
WikiFolders y archivos
Los WikiFolders contienen los siguientes archivos y carpetas:
tiddlywiki.info- Archivo .JSON que contiene metadatos necesarios para construir el wiki\tiddlers- Carpeta que contiene los tiddlers que forman parte del contenido del wiki\plugins- Carpeta que contiene los diferentes plugins folders que se incluyen en el wiki
Sólo el archivo tiddlywiki.info es obligatoriamente necesario. Todas las demás carpetas son opcionales.
Contenido del archivo tiddlywiki.info
Este archivo contiene un objeto JSON que consta de los siguientes campos:
plugins- nombres de los plugins que se incluyen en el wikithemes- nombres de los temas que se incluyen en el wikilanguages- nombres de los idiomas que se incluyen en el wikiincludeWikis- referencias a carpetas externas que se incluyen en el wikibuild- hashmap de targets de compilación, definidos como símbolos de comandos. (ver BuildCommand para más información)config- hashmap opcional de opciones de configuración
includeWikis
Los valores de includeWikis pueden ser bien una cadena con la ruta relativa al wiki, o un objeto con los siguientes campos:
path- ruta relativa al WikiFolderread-only- con el valor true, previene la modificación de los tiddlers del wiki que se incluye. Toda modificación que se haga en estos se guardará en el directorio definido como default-tiddler-location, que se describe más abajo
build
Los tiddlers objeto de este comando cuyo origen no se defina en el archivo tiddlywiki.info se combinarán con los del wiki actual.
config
Las opciones de configuración incluyen:
- default-tiddler-location - ruta relativa a la localización por defecto de la carpeta en que se almacenan los tiddlers nuevos.
- retain-original-tiddler-path - si se define como true, el servidor generará el tiddler
$:/config/OriginalTiddlerPaths, que contiene la ruta original de cada tiddler contenido en el wiki.
Ejemplo:
{
"plugins": [
"tiddlywiki/tiddlyweb",
"tiddlywiki/filesystem"
],
"includeWikis": [
"../tw5.com"
],
"build": {
"index": [
"--rendertiddler","$:/core/save/all","index.html","text/plain"],
"favicon": [
"--savetiddler","$:/favicon.ico","favicon.ico",
"--savetiddler","$:/green_favicon.ico","static/favicon.ico"]
},
"config": {
"retain-original-tiddler-path": true
}
}Contenido de la carpeta tiddlers
Toddos los archivos .tid de la carpeta tiddlers se leen cuando se genera el wiki. Las subcarpetas se escanean recursivamente en busca de cualquier otro archivo .tid durante el proceso.
Los tiddlers nuevos se guardan en la raíz de la carpeta tiddlers, salvo que se configure de otro modo.
Las subcarpetas de tiddlers también pueden contener un archivo JSON que puentee el proceso por defecto para esa carpeta. En este ejemplo se ilustra el formato de este tipo de archivos:
{
"tiddlers": [
{
"file": "d3.min.js",
"fields": {
"type": "application/javascript",
"title": "$:/plugins/tiddlywiki/d3/d3.js",
"module-type": "library"
},
"prefix": "var d3;if($tw.browser){\n",
"suffix": "}\nexports.d3 = d3;\n"
},
{
"file": "cloud/d3.layout.cloud.js",
"fields": {
"type": "application/javascript",
"title": "$:/plugins/tiddlywiki/d3/d3.layout.cloud.js",
"module-type": "library"
}
},
{
"file": "local/mytiddler.tid",
"isTiddlerFile": true,
"fields": {
"title": "A different title"
}
}
],
"directories": [
"../../mytiddlers/store"
]
}Un elemento JSON es un objeto con la propiedad tiddlers, que a su vez contiene una matriz de información sobre cada tiddler que se carga en el wiki. Esta información es:
- Ruta, absoluta o relativa, al archivo que se incluye, bien como
file: nombre del archivo que contiene el tiddlerisTiddlerFile: si su valor estrue, se extraen los tiddlers de su contenido. En caso contrario, se asigna el contenido en bruto del archivo al campotext, sin interpretación alguna.
fields: objet que contiene campos que puentean los proporcionados por el archivoprefix&suffix: (opcional) especifica cadenas usadas como prefijo o sufijo del del contenido de un tiddler
La propiedad directories permite definir una lista de directorios de los que se cargarán recursivamente los tiddlers
The timeline macro returns a list of tiddlers in reverse chronological order of modification (or some other date field), grouped by day.
Parameters
- limit
- The maximum number of tiddlers to include, defaulting to 100. But if any tiddlers are included for a particular day, all of the other tiddlers for that day will also be included – even if this exceeds the limit
- format
- A string specifying the desired format, defaulting to
DDth MMM YYYY - subfilter
- An optional extra filter step, e.g.
tag[MyTag] - dateField
- The name of the date field to use, defaulting to
modified
The tiddlers are selected by means of a filter expression, into which the subfilter and limit parameters are spliced as follows:
[!is[system]$subfilter$has[$dateField$]!sort[$dateField$]limit[$limit$]eachday[$dateField$]]
<<timeline format:"DD/MM/YYYY">><<timeline limit:30 subfilter:"tag[Definitions]" format:"DD/MM/YYYY">>The Tinka plugin provides the ability to create and modify plugins in the browser, without requiring the use of Node.js.
See https://github.com/TinkaPlugin/Tinka for the GitHub repo.
https://tinkaplugin.github.io/
This is a Control Panel extension that aims to simplify the plugin creation and editing process. After installing, you will find a new tab in your control panel that makes creating and modifying plugins a little bit easier.
Una lista es una línea de texto que presenta el título de uno o más tiddlers como una cadena de títulos separados por espacios.
Si un título contiene espacios, se enuncia con corchetes dobles:
EnMarcha [[Descubre TiddlyWiki]] Actualizaciones
La función de creación de listas se usa en varios lugares, incluyendo PermaLinks y el campo lista
Son, de hecho, la forma más simple de filtro y una de las maneras que hay de presentar una selección de títulos.
| purpose | select a single title |
|---|---|
| input | ignored |
! input | a selection of titles |
| parameter | T = a tiddler title |
| output | a selection containing only T |
! output | the input, but with tiddler T filtered out if it exists in the wiki |
[title[An Example]] can be shortened to [[An Example]], because title is the default filter operator.
title is a constructor (except in the form !title), but field:title is a modifier.
[title[HelloThere]]
[[HelloThere]]
HelloThere
[title[HelloThere]] [title[Filter Operators]]
[[HelloThere]] [[Filter Operators]]
HelloThere [[Filter Operators]]
[tag[Filters]] +[!title[Filter Operators]]
[tag[Filters]] +[![Filter Operators]]
[tag[Filters]] -[[Filter Operators]]
| purpose | returns each item in the list with each word capitalised |
|---|---|
| input | a selection of titles |
| output | the input titles with each word capitalised |
[[abc def ghi jkl]titlecase[]]
[[abc deF gHi jKL]titlecase[]]
[[abc deF gHi jKL]lowercase[]titlecase[]]
[tag[HelloThere]titlecase[]]
Introduction
The TranscludeWidget dynamically imports content from another tiddler.
Attributes
| Attribute | Description |
|---|---|
| tiddler | The title of the tiddler to transclude (defaults to the current tiddler) |
| field | The field name of the current tiddler (defaults to "text"; if present takes precedence over the index attribute) |
| index | The index of a property in a DataTiddler |
| subtiddler | Optional SubTiddler title when the target tiddler is a plugin (see below) |
| mode | Override the default parsing mode for the transcluded text to "block" or "inline" |
The TranscludeWidget treats any contained content as a fallback if the target of the transclusion is not defined (ie a missing tiddler or a missing field).
Parsing modes
TiddlyWiki parses text in two modes:
- inline mode recognises character formatting such as emphasis, links
- block mode recognises all the inline formatting, and adds block formatting such as tables, headings and lists
Usually, the mode is determined by whether the transclude widget itself has been parsed in block or inline mode. This can be overridden with the mode attribute.
For example, consider tiddler "A" with this content:
# Item one
#<$transclude tiddler="B"/>
# Item twoAnd a tiddler "B" with this content:
# Item one - a
# Item one - bThe result will be something like this:
- Item one
- # Item one - a # Item one - b
- Item two
This can be fixed by amending tiddler "A":
# Item one
#<$transclude tiddler="B" mode="block"/>
# Item twoSubTiddler Access
The transclude widget allows access to the individual tiddlers stored within a plugin.
The following example will transclude the core version of the tiddler $:/DefaultTiddlers even if it has been overridden:
Transclusion is the process of referencing one tiddler "A" from another tiddler "B" such that the content of "A" appears to be a part of "B".
Copying and pasting content creates multiple copies of the same content in several different places. With transclusion, there can be a single copy and a special instruction in "B" which indicates the point at which content should be inserted from tiddler "A".
Note that if the content of "A" is modified then the modification automatically appears in "B". This makes it easier to maintain repetitive content, by allowing every piece to be written in a single place, but viewed from many.
The concept of transclusion plays an important role in the Philosophy of Tiddlers because it is the primary way in which small items of content are combined.
To learn more:
The power of WikiText comes from the ability to use the content of one tiddler inside another one. This ability takes several different forms that can easily be confused.
The main distinction is between a transclusion and a textual substitution:
- A transclusion is replaced dynamically with the value of either:
- a tiddler field
- a variable
- Textual substitutions are performed on the text of macro definitions before they are used
Tiddler Field Transclusion
Transclusion in WikiText describes the basics of transclusion. For example:
{{MyTiddler}}As described in HTML in WikiText, you can also transclude tiddler field values as attributes of HTML elements and widgets. For example:
<$text text={{MyTiddler}}/>As described in Introduction to filter notation, you can also transclude tiddler field values as filter operands. For example:
{{{ [tag{TiddlerContainingMyTag}] }}}Variable/Macro Transclusion
Variables that were defined with parameter or variable substitution are referred to as "macros". The value of a variable/macro can be transcluded with the syntax:
<<myMacro param:"Value of parameter">>As described in HTML in WikiText, you can also transclude a variable as the value of an attribute of HTML elements and widgets. For example:
<$text text=<<myMacro>>/>As described in Introduction to filter notation, you can also transclude a variable as the value of a filter operand. For example:
{{{ [tag<myMacro>] }}}Textual Substitution
Textual substitution occurs when the value of a macro/variable is used. It is described in Macros in WikiText.
The key difference between substitution and transclusion is that substitution occurs before WikiText parsing. This means that you can use substitution to build WikiText constructions. Transclusions are processed independently, and cannot be combined with adjacent text to define WikiText constructions.
Simple Transclusion
To include some content from TiddlerA into TiddlerB, edit the latter to include the following text:
This is the content of TiddlerA: {{TiddlerA}}The result is that the content of the text field (i.e. the main content) of TiddlerA is rendered within TiddlerB.
Usage
The notation {{TiddlerA}} is a shortcut for {{TiddlerA!!text}}. This is because the default field for transclusion is text, but any other field can be used explicitly. For example, you can print the last time TiddlerA was modified using:
TiddlerA was modified on {{TiddlerA!!modified}}By omitting the tiddler title, the transclusion notation can also be used to display the content of a field from the current tiddler, for example:
The current tiddler was modified on {{!!modified}}Recursion Errors
Notice that using {{!!text}} or {{}} causes an error (Recursive transclusion error in transclude widget), because it does not make sense to include the content of the current tiddler into the content of the current tiddler (that is, into itself). Whenever you encouter this error message, it means that you are trying to include something into itself, directly or indirectly (for example if tiddler A transcludes tiddler B which transcludes tiddler C which, in turn, transcludes tiddler A).
Learning More
In TiddlyWiki, transclusions are not limited to including raw content like the above. To learn about more advanced uses of transclusion, see Transclusion with Templates.
See also:
Introduction
You can incorporate the content of one tiddler within another using the Transclusion notation:
{{MyTiddler}}transcludes a single tiddler{{MyTiddler||TemplateTitle}}displays the tiddler through a specified TemplateTiddler{{||TemplateTitle}}displays the specified template tiddler without altering the current tiddler
Transcluding Text References
You can also use a TextReference instead of a tiddler title:
{{MyTiddler!!field}}transcludes a specified field of a tiddler{{!!field}}transcludes a specified field of the current tiddler{{MyTiddler##index}}transcludes a specified indexed property of a DataTiddler{{##index}}transcludes a specified indexed property of the current DataTiddler
Filtered Transclusion
A similar syntax can be used to transclude a list of tiddlers matching a specified filter:
{{{ [tag[mechanism]] }}}
{{{ [tag[mechanism]] ||TemplateTitle}}}Generated Widgets
The WikiText transclusion syntax generates a TiddlerWidget wrapped around a TranscludeWidget. For example, {{MyTiddler||MyTemplate!!myField}} generates the following pair of widgets:
<$tiddler tiddler="MyTiddler">
<$transclude tiddler="MyTemplate" field="myField"/>
</$tiddler>See also:
The transclusion variable is set by the $transclude widget to a string that identifies the position of that widget within the widget tree.
TiddlyWiki's core uses it to detect recursive transclusion. It is also used to implement the qualify macro.
The string has the following syntax:
- the title of the current tiddler
- the title of the tiddler being transcluded
- the name of the field being transcluded
- the name of the property name or index being transcluded
- the name of the subtiddler being transcluded from a plugin
Many of the five items are often blank.
In the sidebar, the value of transclusion is:
{|$:/core/ui/PageTemplate/sidebar|||}
When the tiddler HelloThere is displayed in the story river, transclusion is set to:
{HelloThere|HelloThere|||}
This example shows how to distinguish between the sidebar and other environments:
We are
<$list
filter="[<transclusion>prefix[{|$:/core/ui/PageTemplate/sidebar|||}]]"
emptyMessage="in the story river.">
in the sidebar.
</$list>In the sidebar, this would show We are in the sidebar instead.
Introduction
In Transclusion Basic Usage we have seen how to include the content of a tiddler A into a tiddler B. Now suppose that tiddler A contains:
@@background-color:yellow;
Hello, my title is {{!!title}}
@@This makes tiddler A display its title with a yellow background (see Styles and Classes in WikiText to learn about CSS style). Imagine that you want to display the title in the same way in tiddler B. But you don't want to copy/paste the style instructions, because you might want to change the background colour later and you want to keep it consistent among tiddlers. This looks like a typical case of transclusion, so let's try to transclude tiddler A in tiddler B the usual way with {{A}}. You should see the following content in tiddler B:
Hello, my title is A
The style is applied as expected, but the title is wrong: we want {{!!title}} to refer to the target tiddler B, and not the source tiddler A.
The solution is to use a template. In this case, the source tiddler A is called the TemplateTiddler, and it is applied to tiddler B using the notation {{||A}}. The difference is that any TextReference which does not refer explicitly to a specific tiddler is applied to the current tiddler, that is, the target tiddler. As a result, tiddler B now looks as expected:
Hello, my title is B
Usage
Transcluding via a template is like applying a mask: assuming that the source tiddler contains generic references (like eye holes in a mask), these will be replaced with the target tiddlers values (like the eyes of the person who wears the mask).
A template can be applied to any tiddler, not necessarily the current one. This is achieved using the full notation {{<target>||<template>}}. The default <target> is the current tiddler (this is what we used in the above example).
Examples
A predefined template to render tags nicely
You can apply the system template $:/core/ui/TagTemplate to a tag in order to see it as a tag pill with a drop-down menu:
{{Transclusion||$:/core/ui/TagTemplate}}is rendered as
See also:
There is a special edition of TiddlyWiki that simplifies creating and maintaining translations:
- https://tiddlywiki.com/editions/translators/ to translate current version of TiddlyWiki
- https://tiddlywiki.com/prerelease/editions/translators/ to translate latest prerelease version of TiddlyWiki
Note that no knowledge of Node.js or GitHub is required.
You can translate TiddlyWiki on Node.js, type tiddlywiki editions/translators --listen and visit http://127.0.0.1:8080/ in your browser.
See https://tiddlywiki.com/dev for technical details of creating and maintaining translations.
The translation mechanism of TiddlyWiki manages and switches between language plugins that provide translations of the TiddlyWiki user interface. The developer site at https://tiddlywiki.com/dev/ explains how translators can create and submit translations for TiddlyWiki.
The title of the current language plugin is read from the tiddler $:/language. If the selected plugin changes then any displayed translateable text automatically changes.
Translation plugins are bundles of tiddlers that each contain an indepedent translatable string. The strings are transcluded as needed.
Translatable strings are generally in the namespace $:/language/, for example:
| purpose | returns each item in the list with whitespace trimmed from the start and end |
|---|---|
| input | a selection of titles |
| output | the input titles with whitespace trimmed from the start and end |
New in: 5.1.20
A personal website built with TiddlyWiki.
TriTarget.org is a name I came up with in high school. I was big into computer programming and wanted a company name that was kinda catchy. When I made a few programs in BASIC I would brand them with TriTarget as a way to show off my company (Even though I didn't have one).
| purpose | truncates a list of numbers to their integer part, removing any fractional part |
|---|---|
| input | a selection of titles |
| output | truncates each of the input numbers to their integer part, removing any fractional part |
New in: 5.1.20 See Mathematics Operators for an overview.
Páginas con tutoriales y consejos relacionados con TiddlyWiki.
Envía más tutoriales que encuentres para ampliar esta lista via GitHub o Twitter, o publícalas en el grupo
"Microblogging con Tiddlywiki" by Juan
A Spanish guide to using TiddlyWiki on Android.
http://3palmeras.wordpress.com/2014/11/05/microblogging-con-tiddlywiki/
Tiddlywiki software is prodigious based on javascript which is capable of holding a notepad that can be edited with Internet Explorer or function as a full blog, contained in a single file.
Translation by Google Translate
"Un wiki sur votre BiblioBox avec TiddlyWiki" from A Penguin in Redmond
A guide (in French) to using TiddlyWiki on the BiblioBox, a variation of the PirateBox mobile communication and file sharing system.
http://bibliobox.net/blog/post/2014/07/16/un-wiki-sur-votre-bibliobox-avec-tiddlywiki
I've known TiddlyWiki since its beginning in 2004. For personal or professional needs, I used it regularly for notepad staff in 2007 and 2012. But I admit I ignored the tool during the past two years. And then I said yesterday: but why not put TiddlyWiki on a BiblioBox? Because it is a single HTML file with javascript. In addition I knew the existence of a server version for saving online amendments.
Hand optimised from a translation by Google Translate
"TW5 Magick" by Stephan Hradek
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
http://tw5magick.tiddlyspot.com/
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
"TW5 Tribal Knowledge" from Scott Kingery
Tips and guides for using TiddlyWiki.
http://techlifeweb.com/tw5tribalknowledge.html
I never used Node.js until a couple weeks ago when I wanted to try a TW5 installation on Node and expand my knowledge a bit. I figured someone else may be in the same boat so I wrote it all down
"Install and run TiddlyWiki on a CentOS 6 VPS using Nginx" from RoseHosting
A step by step guide to running TiddlyWiki on a CentOS Virtual Private Server.
http://www.rosehosting.com/blog/install-and-run-tiddlywiki-on-a-centoos-6-vps-using-nginx/
In this tutorial we will guide you through the steps of installing and running TiddlyWiki on a CentOS 6 VPS.
We will also install and configure Nginx as a reverse proxy, so you can run TiddlyWiki behind Nginx.
"Creating a baby journal with TiddlyWiki 5" from A Penguin in Redmond
A guide to creating a baby journal with TiddlyWiki.
http://a-penguin-in-redmond.blogspot.co.uk/2014/02/creating-baby-journal-with-tiddlywiki-5.html
Keeping a journal about your baby is fun. It allows you to keep track of those events in your baby's life and development that are most important to you, and to tell them in your own words. [...]
There are plenty of online services that can help to keep such a diary, but you need to have an internet connection to access them, and you have to trust them to keep your data safe.
"デザイン刷新。次の25年を目指すTiddlyWiki" by Moongift
An introduction to TiddlyWiki in Japanese.
"Shining Ark Using TiddlyWiki" by Helu
A gamers guide to using TiddlyWiki.
http://helugame.wordpress.com/2013/09/07/shining-ark-7-using-tiddlywiki/
I’ve been using TiddlyWiki for this game mainly to record the monsters’ locations and the items that they drop. This is so that when I need a certain item to upgrade/create weapons, I can quickly look it up; which monsters drop it and which quests have those monsters.
As I play the game, as I encounter new information, I just input them into my Shining Ark TiddlyWiki. It’s like I’m building a wiki from scratch. The reason why I don’t just use online wikis is that 1) it’s too easy to get spoiled and 2) sometimes online wikis provide too much information (who cares about the non-gameplay related descriptions that can be found in the game, etc).
The tv-adjust-heading-level variable allows the level of headings to be adjusted. It is interpreted as a positive or negative number (e.g. "2" or "-3") that is added to the heading level for display.
Note that if the resulting heading level is less than 1 then level 1 is used instead. This means that specfiying a large negative adjustment factor will reset all headings to display as level 1. Similarly, heading levels larger than 6 are clamped to the maximum HTML heading level of 6.
Tiddlers
Sample Headings 1,2,3
! This is a Level 1 Heading
This is a paragraph.
<$vars tv-adjust-heading-level="-2">
{{Sample Headings 3,4,5}}
</$vars>
!! This is a Level 2 heading
<$vars tv-adjust-heading-level="-1">
{{Sample Headings 4,5,6}}
</$vars>
Sample Headings 3,4,5
!!! This is written as a Level 3 heading
!!!! This is written as a Level 4 heading
!!!!! This is written as a Level 5 heading
Sample Headings 4,5,6
!!!! This is written as a Level 4 heading
!!!!! This is written as a Level 5 heading
!!!!!! This is written as a Level 6 heading
Example
<$transclude tiddler="Sample Headings 1,2,3" mode="block"/>La variable tv-auto-open-on-import controla si el mensaje tm-import-tiddlers abre en el StoryRiver el tiddler $:/Import (que muestra la lista de tiddlers pendientes de importación).
Por defecto, el tiddler se abre, pero si la variable tiene valor no, no lo hace.
Un ejemplo de ajuste de esta variable con valor no puede verse en el plugin de actualización en el asistente de actualización de TiddlyWiki, donde el usuario arrastra los archivos que quiera actualizar pero en pantalla no se muestra la importación del modo habitual.
The tv-config-toolbar-icons variable controls whether toolbar buttons display icons.
It can be set to yes or no prior to transcluding such a button.
The standard page template sets it to the value found in $:/config/Toolbar/Icons, with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the Configuración tab of the Control Panel.
See also tv-config-toolbar-text.
The tv-config-toolbar-text variable controls whether toolbar buttons display text.
It can be set to yes or no prior to transcluding such a button.
The standard page template sets it to the value found in $:/config/Toolbar/Text, with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the Configuración tab of the Control Panel.
See also tv-config-toolbar-icons.
New in: 5.1.15 The tv-filter-export-link variable controls the value of the href attribute on the HTML a element generated by the $link widget. If defined, it takes precedence over the tv-wikilink-template Variable.
The variable is treated as a filter that is given the target tiddler title as input. The filter is evaluated and the first result is used as the href attribute.
For example:
\define tv-filter-export-link() [encodeuricomponent[]encodeuricomponent[]addsuffix[.html]]See also the tv-get-export-link variable, which dominates over this one.
The tv-get-export-image-link variable controls the value of the src attribute on the HTML img element generated by the $image widget when the value of its source attribute is not the title of a tiddler.
The variable should be a macro with the following parameter:
- src
- The value of the
sourceattribute – equivalent to the image name specified in the shorthand syntax[img[source]]
The ability to override image URIs in this way can be useful when one is using the Node.js configuration to export a static version of a wiki.
This example fetches the TiddlyWiki icon:
\define tv-get-export-image-link(src) https://www.tiddlywiki.com/$src$
[img[favicon.ico]]The tv-get-export-link variable controls the value of the href attribute on the HTML a element generated by the $link widget.
The variable should be a macro with the following parameter:
- to
- The title of the target tiddler of the link, with no escaping
See also tv-wikilink-template. If both that variable and this one exist, this one dominates.
The tv-get-export-path variable specifies the full pathname to which the rendertiddlers Node.js command writes each tiddler.
The variable should be implemented as a JavaScript macro with the following parameter:
- title
- The title of the tiddler
If no such macro exists, the tiddlers are written to files whose names are percent-encoded, in the command's output folder.
The tv-history-list variable is assigned by the NavigatorWidget to contain the title of the tiddler containing the current history list.
Compare tv-story-list.
The tv-show-missing-links variable defines if missing links within the scope of the variable are rendered as links or not.
Globally, the variable is set within the PageTemplate and can be changed in the $:/ControlPanel under Settings - Show missing links to tiddlers
If tv-show-missing-links is set to no, missing links are rendered as plain text
If tv-show-missing-links is set to yes, missing links are rendered as wiki-links
The tv-story-list variable is assigned by the NavigatorWidget to contain the title of the tiddler containing the current story list.
Compare tv-history-list.
The tv-tiddler-preview variable indicates whether content is being rendered in a tiddler preview panel.
The value is yes within the preview panel, and undefined elsewhere.
The tv-wikilink-template variable controls the value of the href attribute on the HTML a element generated by the $link widget. The tv-filter-export-link, if defined, it takes precedence over the tv-wikilink-template variable.
The variable is treated as if it was a macro with the following parameters:
- uri_encoded
- The title of the target tiddler of the link, but percent-encoded
- uri_doubleencoded
- The value of the
uri_encodedparameter but percent-encoded again, i.e. with its%characters further converted to%25
\define tv-wikilink-template() ../tiddlers/$uri_encoded$.html
The variable defaults to #$uri_encoded$.
See also the tv-get-export-link variable, which dominates over this one.
This example shows a way of giving links a tooltip derived from the target tiddler's caption field:
\define tv-wikilink-tooltip()
<$transclude field="tooltip">(<$transclude field="caption"/>)</$transclude>
\end
Here is a link to [[backlinks Operator]] with a custom tooltip.Here is a standard link for comparison.
The tv-wikilinks variable controls the behaviour of the $link widget.
The widget normally produces a link to a tiddler. But if this variable has the value no, the widget suppresses the link and simply displays the text that would otherwise have served as the link.
You can suppress links for a whole tiddler by placing the following line at the start of the tiddler's text:
\define tv-wikilinks() no
This variable has no effect on external links, as those do not involve the $link widget.
HelloThere,
[[HelloThere]],
<$link to="HelloThere">is //this// a link?</$link><$set name="tv-wikilinks" value="no">
HelloThere,
[[HelloThere]],
<$link to="HelloThere">is //this// a link?</$link>
</$set>Este es un plugin experimental que añade la funcionalidad de mostrar WikiText escrito para la primera versión "Classic" de TiddlyWiki.
Está disponible en: https://tiddlywiki.com/plugins/tiddlywiki/tw2parser/
TiddlyWiki5 Packaged with the multi-user plugin in a single executable file.
https://github.com/OokTech/TW5-SingleExecutable
Tiddlywiki, node js, multiuser plugin - all packaged into a single file so user can just download the file and run it and not have to install anything else. Versions available for windows, osx, and linux.
A collection of hints and tips, musings and proposals from long-time TiddlyWiki contributor Mat Goldman.
http://twaddle.tiddlyspot.com/
This is Mat's, a.k.a <:-) little man-cave in the TiddlyVerse.
Most TW development is, understandably, based on the premise that "Improve code ➔ Better TW". TWaddle is also about developing TW but from the perspective that Bigger community ⇄ Better TW. Thus, TWaddle looks more to people issues - how to attract them, how to make them stick with TW etc.
I'm not a programmer but I am a TW enthusiast so I tiddlefiddle enough to make the occasional discovery of something cool. Given the amount of words I utter, it is also a mere numbers game before I say something that makes sense. TWaddle is intended to capture these eventualities.
The CommunitySearch wiki aggregates many public wikis from the community. It is updated automatically every day. At the time of writing, more than 5000 tiddlers are indexed, thus giving access to the largest known collection of TW content.
It lets you search for some specific content among a preselected list of wikis. The indexed content is mostly focused on TW usage, so you would typically use this search system to find information about a particular aspect of TiddlyWiki. Say for example that you want to learn how to make a table of content, type "table of content" in the CommunitySearch box (also accessible in the default tiddler GettingStarted). The search results are links to various wikis, and point directly to the specific tiddlers containing your request.
The CommunitySearch wiki also lets you:
- Browse the list of wikis
- Browse the list of author
- Browse the list of plugins
- Access content by tag (see also BookmarkingTags)
- Follow the latest news from the community (and publish your own news if you are a wiki author)
This plugin adds a <$twitter> widget that can embed a variety of entities from twitter.com:
- Individual tweets and conversation threads
- Buttons to tweet a hashtag/account, follow/like an account, or share a URL
- Timelines showing tweets from a user, hashtag, list or collection
An authentication proxy for your TiddlyWiki.
https://github.com/stevenleeg/twproxy
One of my favorite aspects of TiddlyWiki has been that it's web-based, making it possible for me to access my wiki from everywhere (especially my phone). That being said, I'm a bit paranoid, so I was left a bit unsatisfied with the tiddlywiki server's HTTP basic auth for protecting my wiki. ~23 commits later, I've created something called twproxy that I'd like to share with you all today, as I'm hoping somebody other than myself will find it useful.
Essentially it is a simple proxy that puts your wiki behind a username, password, and optional 2-factor auth prompt. This gives you added security in addition to the ability to remember your credentials past one browsing session (I was getting sick and tired of typing my username/password in over and over using basic auth).
WikiText can include blocks of text that are rendered with an explicit ContentType like this:
$$$image/svg+xml
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
<circle cx="100" cy="50" r="40" stroke="black" stroke-width="2" fill="green" />
</svg>
$$$This renders as:
It is also possible to abbreviate the ContentType to a file extension. For example:
$$$.svg
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
<circle cx="100" cy="50" r="40" stroke="black" stroke-width="2" fill="red" />
</svg>
$$$This renders as:
Unknown types render as plain text:
$$$text/unknown
Some plain text, which will not be //formatted//.
$$$Which renders as:
Some plain text, which will not be //formatted//.A render type can also be specified, causing a particular text rendering to be displayed. For example:
$$$text/vnd.tiddlywiki>text/html
This is ''some'' wikitext
$$$
$$$text/vnd.tiddlywiki>text/plain
This is ''some'' wikitext
$$$Renders as:
<p>This is <strong>some</strong> wikitext</p>
This is some wikitext
Se recomienda el uso de las macros de documentación para facilitar las futuras tareas de mantenimiento del texto frente a nuevos cambios y actualizaciones.
Se recomienda precaución en el uso arbitrario de estilos directos de formato (negrita, cursiva ...etc). Si se puede usar una macro, conviene usarla. Si no existe la macro adecuada, se puede crear o, si no se sabe cómo, pedir su creación en el Grupo de Google.
Por el mismo motivo, se aconseja el uso de acentos graves `...` para transcribir fragmentos de código y WikiText, pero no para nombres de cosas tales como campos, operadores, variables o widgets. Estas tienen su macro correspondiente.
Para mantener cierto orden y evitar colisiones de código al usar distintos sistemas operativos:
- Apóstrofos y comillas deben ser del tipo recto
'" - Las elipsis se señalan con tres puntos individuales
..., en lugar de con "puntos suspensivos"…. - Se recomienda evitar el uso de un único guión como signo de puntuación. En su lugar, debe usarse guión doble
--–que TiddlyWiki interpreta como guión corto o "en-dash"–. - Los elementos de una lista o tabla llevan punto al final únicamente si se trata de frases completas. Si no es así, no llevan puntuación alguna.
- Sólo por si acaso, haz copia de seguridad de tu archivo HTML de TiddlyWiki
- Abre la pestaña Plugins del Panel de control
- Pincha el nombre del plugin que quieres desinstalar para abrir el tiddler que lo contiene.
- Pincha el botón
- Pincha el botón
- Guarda los cambios con el botón
- Recarga la página
- El plugin se ha desinstalado por completo
Extrae los tiddlers de un plugin y los presenta como tiddlers ordinarios
--unpackplugin <title>| purpose | discard any input titles that have tags |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | those input tiddlers that have no tags |
! output | those input tiddlers that have at least one tag |
A tiddler is deemed to have no tags if it:
- doesn't exist
- doesn't have a
tagsfield - has an empty
tagsfield
| purpose | rounds a list of numbers to the next integer with largest absolute value, that is, away from zero |
|---|---|
| input | a selection of titles |
| output | rounds each of the input numbers to the next integer with largest absolute value, that is, away from zero |
New in: 5.1.20 See Mathematics Operators for an overview.
[[1.6]untrunc[]]
[[-1.6]untrunc[]]
=-1.2 =-2.4 =3.6 =4.8 =5.1 +[untrunc[]]
The unusedtitle macro returns an unused title. Optionally you can provide a base title to generate the new title.
It uses the same method as the create new tiddler button, a number is appended to the end of the base name.
Parameters
- baseName
- A string specifying the desired base name, defaulting to
New Tiddler
- Open upgrade.html
- Includes a data tiddler called
$:/UpgradeLibrarythat contains the latest compatible versions of all plugins in the library - Drag in old wiki file
- Place tiddlers into a data tiddler
$:/Importthat is typed as a "pending import" - Kick off import processing for each tiddler
- Give each "upgrader" module a chance to inspect the incoming tiddlers
- Upgrader modules can trigger actions for each tiddler:
- Display a warning message
- Don't import
- Replace with another tiddler from the upgrade library
- Disable incompatible plugins
- Display the newly created pending import tiddler through a new view template segment
- Displays the payload tiddlers as a list of titles and checkboxes, with a dropdown showing the full details of the tiddler
- Perhaps we also suppress the usual JSON display for data tiddlers behind a reveal widget
- The user can adjust the selection checkboxes
- Clicking "Upgrade" unpacks the selected tiddlers from the pending import tiddler
- The pending import tiddler and the upgrade library tiddler are excluded from the subsequent save operation
Se publican con regularidad nuevas versiones de TiddlyWiki que incorporan correcciones de "bugs" y mejoras. Es buena idea mantenerse al día actualizándolo a la última versión.
Actualización online
Este procedimiento funcionará en la mayoría de navegadores. Ni uno solo de tus datos personales saldrá de tu ordenador durante todo el proceso.
- Localiza el archivo HTML de TiddlyWiki en tu disco duro
- Abre el navegador y ve a https://tiddlywiki.com/upgrade.html. Ahí encontrarás el "Upgrader": asistente de actualización de TiddlyWiki. Tiene una gran flecha en el centro y, debajo de ella, el número de versión al que corresponde
- Arrastra el archivo HTML de TiddlyWiki a la ventana del navegador donde tienes el Upgrader y suéltalo sobre la flecha
- Si tu archivo está cifrado, se te pedirá la contraseña
- Se te mostrará una tabla de tiddlers
- Son absolutamente todos los tiddlers que forman parte de tu versión de TiddlyWiki
- En la columna Select, verás marcados los tiddlers que formarán parte de la nueva versión.
Guarda los cambios de la nueva versión #* Los tiddlers que NO se actualizarán aparecen desmarcados y una nota en la columna status te dice el motivo. Si todo te parece bien...
- ...haz clic en el botón Upgrade, que tienes arriba del todo
- Haz clic en el botón verde Save upgraded TiddlyWiki file
El navegador te pedirá que descargues un archivo llamado "upgrade.thml". Este archivo es la versión actualizada de tu archivo. Localízalo en tu disco duro, cambia el nombre por el de tu wiki y sustituye en su localización el viejo archivo por el nuevo.
Actualización offline
Puedes descargar el Upgrader a tu disco duro y realizar el proceso anterior de arrastra-y-suelta para actualizar tu archivo localmente, sin necesidad de conexión de red.
Problemas conocidos durante la actualización
Firefox Security Restrictions
Se han dado casos del siguiente error al intentar actualizar en Firefox:
Error while saving:
Error:NS_ERROR_DOM_BAD_URI: Access to restricted URI denied
- La actualización falla o se interrumpe por restricciones de seguridad de Firefox.
- Comprueba si la versión de Firefox instalada en tu ordenador es la última disponible. En caso negativo, actualiza el navegador y vuelve a intentarlo.
- Si el error persiste, sugerimos usar otro navegador o actualizar TiddlyWiki offline
Customizaciones incompatibles
Es posible –y se han dado casos de ello– que customizaciones de versiones anteriores de ~Tiddlywiki dejen de funcionar después actualizar el núcleo a la última versión.
Hay dos maneras maneras en que puedes diagnosticar y solucionar los problemas que se presenten:
- Repite la actualización deseleccionando manualmente los tiddlers de tu versión que aplican customizaciones a TiddlyWiki
- Desactiva las customizaciones abriendo TiddlyWiki en Modo seguro
Si has instalado TiddlyWiki en Node.js de la forma habitual, puedes actualizarlo a la última versión con este comando:
npm update -g tiddlywikiEn Mac o Linux necesitas añadir "sudo":
sudo npm update -g tiddlywiki| purpose | returns each item in the list as uppercase |
|---|---|
| input | a selection of titles |
| output | the input titles with each lowercase letter replaced by the equivalent uppercase letter |
A URI (also often known as a URL) is a string of characters used to specify the location of a resource such as a web page.
By default, when running TiddlyWiki on Node.js, the server exposes the wiki at the URI formed from the protocol, host and port - for example, http://127.0.0.1:8080/.
There are two steps to running the wiki at a custom path like http://127.0.0.1:8080/path/to/my/wiki/:
- Configure the server by passing
/path/to/my/wikias the pathprefix argument of the ServerCommand - Configure the client by creating a tiddler called
$:/config/tiddlyweb/hostthat contains$protocol$//$host$/path/to/my/wiki/
By default, TiddlyWiki's WebServer serves resources over the insecure HTTP protocol. The risk is minimal if it is only being used within a private, trusted network but in many situations it is desirable to use a secure HTTPS connection.
HTTPS requires the server to be configured with a certificate via a "cert" file and a "key" file, configured via the tls-cert and tls-key parameters
Certificates can be obtained from a certification authority such as https://letsencrypt.org/, or you can create a self-signed certificate for internal testing.
To create the required certificate files with the popular openssl utility:
openssl req -newkey rsa:2048 -new -nodes -keyout mywikifolder/key.pem -out mywikifolder/csr.pem
openssl x509 -req -days 365 -in mywikifolder/csr.pem -signkey mywikifolder/key.pem -out mywikifolder/server.crt
tiddlywiki mywikifolder --listen username=joe password=bloggs tls-key=key.pem tls-cert=server.crtPara moverte de un tiddler a otro puedes usar enlaces (generalmente de color azul). Pinchar cualquier enlace te llevará automáticamente al tiddler en cuestión. Si está cerrado, lo abrirá. Lo fabuloso de TiddlyWiki es que hace los enlaces a tiddlers tan accesibles como sea posible. ¡Hay enlaces por todos lados! Estos son los lugares clave donde puedes encontrar enlaces a otros tiddlers en TiddlyWiki:
- En el cuerpo de cualquier tiddler puedes crear un link a otro tiddler, tanto si ya existe como si no. Enlaces en WikiText te muestra varias formas sencillas de crear enlaces entre tiddlers.
- Cada pastilla que veas en un tiddler (como la que hay bajo el título de este tiddler, que dice Working with TiddlyWiki, contiene un enlace al tiddler de su correspondiente etiqueta.
- El InfoPanel de un tiddler te muestra cuatro pestañas que contienen listas adicionales de enlaces relacionados con este.
- La pestaña Referencias te da una lista de los enlaces que apuntan al tiddler actual
- Etiquetado muestra una lista de enlaces de tiddlers etiquetados con el título del actual.
- Lista muestra una lista de enlaces de tiddlers mencionados en el campo
listdel tiddler actual. - En lista de muestra una lista de enlaces de tiddlers que incluyen el actual en sus respectivos
list
- Las pestañas de la barra lateral también contienen innumerables enlaces a tiddlers:
- Abiertos muestra una lista de tiddlers actualmente abiertos. Es decir, a la vista.
- Recientes enumera los últimos 100 tiddlers modificados, por orden ascendente de antigüedad.
- Más ofrece ocho listas adicionales de enlaces:
- Todos contiene la lista alfabética de todos los tiddlers del wiki.
- Etiquetas contiene la lista alfabética de todas las etiquetas del wiki. Pinchando en cualquiera de ellas, además, obtienes una lista alfabética de todos los tiddlers etiquetados con ella
- Vacíos contiene la lista de enlaces vacíos, es decir, que enlazan con tiddlers que aún no existen. Función muy útil para encontrar aquellos tiddlers que uno planeó escribir cuando redacta
- Borradores contiene la lista de tiddlers que actualmente están en borrador. TiddlyWiki considera que, mientras esté en edición, un borrador es un tiddler aparte del original, de modo que mientras se edita, existen dos tiddlers iguales e independientes, lo que por un lado conserva intacto el contenido original hasta que se pulse el botón y, por otro, nos permite trabajar tranquilamente en un borrador sin mostrar tiddlers inacabados ni perder cambios
- Huérfanos contiene la lista de aquellos tiddlers que no enlazan a ningún otro ni mediante links, ni etiquetas ni listas. Muestra qué tiddlers necesitan integrarse con el resto, algo muy útil a la hora de editar un wiki
- Tipos contiene una lista por tipo de contenido de tiddlers con contenido especial, como imágenes, audio, código, archivo PDF ...etc
- Sistema contiene la lista de todos los tiddlers de sistema
- Ocultos contiene la lista de todos los tiddlers ocultos.
- FInalmente, también puedes crear tus propias listas de enlaces, usando varios métodos:
- Por transclusión de filtros: si escribimos
{{{[tag[Contents]]}}}en un tiddler, nos mostrará la lista de tiddlers que llevan la etiqueta Contents. - Puedes usar ListWidget. Es algo más complejo que la transclusión de filtros, pero a cambio te da más flexibilidad a la hora de diseñar la lista para que se muestre tal y como quieres.
- Por transclusión de filtros: si escribimos
El primer paso para cambiar la apariencia de TiddlyWiki es elegir y aplicar uno de los temas disponibles o modificar la paleta de colores.
Además, pueden definirse hojas de estilos CSS mediante la etiqueta $:/Stylesheet. Intenta crear una hoja de estilos con el siguiente contenido para cambiar el actual color de fondo a rojo:
html body.tc-body {
background: red;
}Puentear estilos del tema
Las hojas personales de estilos se aplican independientemente de los estilos definidos por el tema. Por ello, a menudo es necesario que las reglas CSS de tu hoja de estilos sean más específicas que las del tema que quieres puentear. Por ejemplo, html body.tc-body es más específco que body.tc-body.
Tipo "estilos"
Normalmente es mejor definir como el valor text/css. Así te aseguras de que TiddlyWiki entienda el contenido como hoja de estilos en texto plano y no aplique reglas de WikiText en su interpretación.
Si necesitas usar macros y transclusiones en tu hoja de estilos, tendrás que usar el type por defecto text/vnd.tiddlywiki, permitiendo así el proceso de WikiText. Ahí va un ejemplo:
\rules only filteredtranscludeinline transcludeinline macrodef macrocallinline html
body.tc-body pre {
<<box-shadow "inset 0 1px 0 #fff">>
}La directiva \rules al inicio restringe la aplicación de reglas WikiText a exclusivamente macros y transclusiones, lo que impide que accidentalmente se active cualquier otro proceso indeseado.
Un tiddler de estilos se procesa de tal manera que primero se procesa como WikiText y, entonces, el resultado se aplica como CSS. Por lo tanto, se ignora todo tag HTML usado en los estilos. Así, por ejemplo, aquellos elementos HTML generados por RevealWidget no afectarán en absoluto al resultado. Por ese motivo pueden envolverse las reglas CSS en tags <pre> para mostrarlos como bloques de código, sin que afecten al proceso.
\rules only filteredtranscludeinline transcludeinline macrodef macrocallinline html
<pre>body.tc-body pre {
<<box-shadow "inset 0 1px 0 #fff">>
}
</pre>Stylesheet Macros
El núcleo de TiddlyWiki proporciona una serie de macros globales, útiles para la construcción de hojas de estilos.
TiddlyWiki5 allows you to use SVG to display vector graphics in two ways:
- Tiddlers with the type
image/svg+xmlare interpreted as SVG images, and displayed and transcluded as self-contained<img>elements with the SVG embedded as a data URI in thesrcattribute.- For examples of SVG images see Motovun Jack.svg and Tiddler Fishes.svg
- WikiText can also include inline SVG elements directly. See below for an example.
Embedding SVG tiddlers
You can embed an SVG image tiddler using the ordinary transclusion syntax:
{{Motovun Jack.jpg}}You can also use Typed Blocks in WikiText to embed an inline SVG tiddler.
The implications of the image being rendered within an <img> element are that it is sandboxed; it can't use CSS styles from the parent document, for example. Neither can the image use WikiText features like transclusion.
Embedding SVG elements
The other way to use SVG is to embed the <svg> element directly. For example:
Note that inline SVG elements don't need an <?xml version="1.0"?> directive.
Including HTML or WikiText content in SVG images
You can include simple text strings in SVG images using the <text> element:
HTML or WikiText content can be included within inline SVG images using the <foreignObject> element. For example:
Transcluding SVG elements
When embedding SVG elements you can also use WikiText features like transclusion. For example, here is an SVG circle with the radius set to the value in the tiddler $:/SVGExampleRadius:
You can edit the value of the radius here:
Making curved text with SVG
Este ejemplo muestra cómo usar SVG para mostrar transclusiones de texto a lo largo de un recorrido. Escribe algo en el cuadro de texto para probarlo.
Este es el código:
\define textOnPath(text)
$$$.svg
<svg width="100%" height="100%" viewBox="0 0 1000 300" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="background:white;">
<defs>
<path id="MyPath" d="M 100 200 C 200 100 300 0 400 100 C 500 200 600 300 700 200 C 800 100 900 100 900 100"/>
</defs>
<use xlink:href="#MyPath" fill="none" stroke="#ddd"/>
<text font-family="'Helvetica Neue', Helvetica, Arial, 'Lucida Grande', sans-serif" font-size="42.5">
<textPath xlink:href="#MyPath">
$text$
</textPath>
</text>
</svg>
$$$
\endSetting the root-tiddler parameter to $:/core/save/all-external-js switches to a special template that externalises TiddlyWiki's core JavaScript into a separate file. For example:
tiddlywiki editions/tw5.com-server/ --listen host=0.0.0.0 "root-tiddler=$:/core/save/all-external-js"Background
TiddlyWiki in the single file configuration ordinarily packs everything into a single file: your data, and the JavaScript, CSS and HTML comprising TiddlyWiki itself. This lack of dependencies is usually very convenient: it means that it is impossible for the parts of a TiddlyWiki to become separated, and enormously improves the chances of it still functioning in the future.
However, there is some inefficiency in this arrangement because the core code is repeatedly loaded and saved every time the content of the wiki is saved. This inefficiency is partially ameliorated when working in the client server configuration because once the wiki is loaded by the browser the synchronisation process only transmits individual tiddlers back and forth to the server.
The remaining inefficiency when working in the client server configuration is that the single page wiki that is initially loaded will contain a copy of the entire core code of TiddlyWiki, making it impossible for the browser to cache it.
Any files in the subfolder files of the wiki folder will be available via the route \files\<uri-encoded-filename>. For example: http://127.0.0.1:8080/files/Motovun%20Jack.jpg
This can be useful for publishing large files that you don't want to incorporate into the main wiki (PDFs, videos, large images, etc.).
Static files can be referenced directly:
[ext[./files/a-big-document.pdf]]- to make a link to a PDF[img[./files/a-big-image.png]]- to embed an image
Alternatively, the _canonical_uri field can be used to reference the files as external tiddlers.
TiddlyWiki's experimental single tiddler per page, read-only view uses a simplified page layout, and implements links between tiddlers, but there are no other interactive features. Compared to a full TiddlyWiki user interface, it is very lightweight and usable even over very slow connections.
Alongside serving the full interactive wiki at the path / (e.g. http://127.0.0.1:8080/), TiddlyWiki serves each tiddler at the path /<url-encoded-tiddler-title>. For example:
Ordinary, non-system tiddlers are rendered through a special view template while system tiddlers are rendered through a template that returns the raw text of the rendered output. In this way ordinary tiddlers can be browsed by end users while system tiddlers can be included in their raw form to use them as JS, HTML or CSS templates. Additionally these defaults can be overwritten on a per tiddler basis by specifying the _render_type and _render_template fields accordingly.
The templates are controlled by these parameters:
TiddlyWiki5 can be used to produce documentation for GitHub projects. It lets you maintain a single set of documentation as a TiddlyWikiFolder containing separate tiddler files under source code control, and then use it to produce readme.md files for inclusion in project folders, or HTML files for storage in GitHub Pages. Both features are demonstrated by TiddlyWiki5 itself.
Generating readme.md files
When displaying the contents of a folder GitHub will look for a readme.md file and display it. Note that it will not display full HTML files in this way, just static MarkDown files (this is a security measure). Happily MarkDown permits a safe subset of HTML, and thus to generate a readme.md file that is suitable for GitHub it is just necessary for TiddlyWiki5 to generate the content of the <body> element of an HTML document, and give it the appropriate filename.
This is done with this command:
--rendertiddler ReadMe ./readme.md text/htmlIt saves the tiddler ReadMe to the file ./readme.md in the text/html format.
By default, tiddler links will be rendered as <a> links to a relative URI consisting of the title of the tiddler. This behaviour can be overridden by defining the macro tv-wikilink-template, as is done at the top of the tiddler ReadMe:
\define tv-wikilink-template() https://tiddlywiki.com/static/$uri_doubleencoded$.htmlSee the LinkWidget for more details.
In this example, tiddler links are rendered as links to the static rendering of tw5.com.
TiddlyWiki se puede usar desde la línea de comandos para ejecutar una larga lista de operaciones basadas en carpetas, tiddlers y archivos HTML de ~Tiddlywiki.
Por ejemplo, el siguiente comando carga tiddlers de un archivo HTML de TiddlyWIki y guarda uno de ellos (ReadMe) como HTML estático (readme.html):
tiddlywiki --verbose --load mi_wiki.html --rendertiddler ReadMe ./readme.htmlEjecutar TiddlyWiki desde la línea de comandos pone en marcha el núcleo, carga los plugins y establece un "almacén" de tiddlers en blanco. A partir de entonces procesa los argumentos de la línea de comandos de izquierda a derecha. Los argumentos se separan con espacios.
El primer argumento es la ruta opcional al WikiFolder que se va a cargar. Si no se especifica, se usa el directorio actual.
Le siguen uno o varios comandos con sus respectivos argumentos. Los comandos se identifican con el prefijo --.
tiddlywiki [<ruta>] [--<comando> [<argumento>[,<argumento>]]]Los comandos disponibles son:
~Tiddlywiki permite el uso de imágenes SVG de dos maneras:
- Los tiddlers de tipo
image/svg+xmlse interpretan como imágenes SVG, es decir que se muestran como elementos<img>con el SVG incrustado en el atributosrc.- Como ejemplos de imagen SVG, véanse Motovun Jack.svg y Tiddler Fishes.svg
- También pueden incluirse elementos SVG directamente con WikiText.
Transclusión de tiddlers SVG
Se pueden incrustar SVG's mediante transclusión
{{Motovun Jack.jpg}}Incrustación de elementos SVG
La otra forma de usar un SVG es incrustándolo directamente.
Al incrustar un SVG en el texto como elemento <img>, este permanece en un entorno restringido y contenido. No puede, por ejemplo, usar los estilos CSS del documento padre, por ejemplo, ni se puede hacer una transclusión aislada del SVG.
También puede incluirse el <svg> directamente.
Este es el código...
<svg width="150" height="100">
<circle cx="100" cy="50" r="40" stroke="black" stroke-width="2" fill="red" />
</svg>...y este el resultado:
Para hacerlo, no necesitamos la directiva <?xml version="1.0"?>.
Inclusión de contenido HTML o WikiText en imágenes SVG
Se pueden incluir sencillas cadenas de texto en un SVG mediante el elemento <text>
Este es el código...
<svg width="300px" height="30px" viewBox="0 0 1000 300"><text x="250" y="150" font-family="Verdana" font-size="200">Hello, out there</text><rect x="1" y="1" width="998" height="298" fill="none" stroke-width="2" /></svg>...y este el resultado
Se puede incluir HTML o WikiText dentro de imágenes SVG incrustadas en el texto mediante el elemento <foreignObject>. Por ejemplo:
<svg width="260px" height="260px"><circle cx="150" cy="150" r="100" fill="blue" stoke="red"/><foreignObject x="70" y="110" width="150" height="180"><body>Esto es un poco de texto que incluye un [[enlace a otro tiddler|HelloThere]].</body></foreignObject></svg>Incrustación y transclusión combinadas
Al definiri elementos SVG podemos jugar con algunos de sus parámetros mediante transclusión. Como ejemplo, veamos el caso de este círculo SVG que podemos modificar mediante transclusión del valor de su radio desde el tiddler $:/SVGExampleRadius:
Este es el código...
<svg width="150" height="150"><circle cx="75" cy="75" r={{$:/SVGExampleRadius}} stroke="black" stroke-width="2" fill="green"/></svg>...y este el resultado:
Podemos variar el radio del círculo (como podríamos variar cualquier otro parámetro con la misma técnica) editando el siguiente valor, alojado en otro tiddler:
Texto curvo en SVG's
Este ejemplo muestra cómo usar SVG para mostrar transclusiones de texto a lo largo de un recorrido. Escribe algo en el cuadro de texto para probarlo.
Este es el código:
\define textOnPath(text)
$$$.svg
<svg width="100%" height="100%" viewBox="0 0 1000 300" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="background:white;">
<defs>
<path id="MyPath" d="M 100 200 C 200 100 300 0 400 100 C 500 200 600 300 700 200 C 800 100 900 100 900 100"/>
</defs>
<use xlink:href="#MyPath" fill="none" stroke="#ddd"/>
<text font-family="'Helvetica Neue', Helvetica, Arial, 'Lucida Grande', sans-serif" font-size="42.5">
<textPath xlink:href="#MyPath">
$text$
</textPath>
</text>
</svg>
$$$
\endA variable is a snippet of text that can be accessed by name within a particular branch of the widget tree. The snippet is known as the variable's value.
A new variable is defined using a $set widget, and is then available to any of the children of that widget, including transcluded content. A $set widget can reuse an existing name, thus binding a different snippet to that name for the duration of the widget's children.
The $list widget also sets a particular variable (currentTiddler by default) to each listed title in turn.
For an overview of how to use variables, see Variables in WikiText.
Despite the term "variable", each snippet is a constant string. The apparent variability is actually the result of the presence of multiple variables with the same name in different parts of the widget tree.
Macros are a special form of variable whose value can contain placeholders that get filled in with parameters whenever the macro is used.
By themselves, the snippets are not parsed as WikiText. However, a variable reference will transclude a snippet into a context where WikiText parsing may be occurring. Within a snippet, the only markup detected is $name$ for a macro parameter transclusion and $(name)$ for a variable transclusion.
The dumpvariables macro lists all variables (including macros) that are available at that position in the widget tree.
TiddlyWiki's core has several variables built in.
See also the introduction to the concept of variables.
To transclude the value of a variable, use the macro call syntax with no parameters. You can also use a $macrocall widget.
A macro snippet can contain $(name)$ as a placeholder for which the value of the variable of that name will be substituted.
A variable's value can be used as a filter parameter, or as a widget attribute. The latter supports macro parameters.
Example: defining a variable
<$set name=animal value=zebra>
<<animal>>
</$set>Example: defining a macro
The \define pragma below defines a macro called tags-of-current-tiddler. The macro returns the value of the tiddler's tags field, and can be accessed from anywhere else in the same tiddler (or in any tiddler that imports it).
\define tags-of-current-tiddler() {{!!tags}}
The tags are: <<tags-of-current-tiddler>>Example: using a variable as a filter parameter
This example uses the backlinks operator to list all tiddlers that link to this one.
<<list-links filter:"[<currentTiddler>backlinks[]]">>| purpose | select the names of all the actively defined variables |
|---|---|
| input | ignored |
| parameter | none |
| output | the names of all the actively defined variables |
New in: 5.1.20 The primary purpose of the variables operator is to implement the dumpvariables Macro:
\define dumpvariables()
<ul>
<$list filter="[variables[]]" variable="varname">
<li>
<strong><code><$text text=<<varname>>/></code></strong>:<br/>
<$codeblock code={{{ [<varname>getvariable[]] }}}/>
</li>
</$list>
</ul>
\end
[variables[]prefix[colour]]
Introduction
The vars widget allows multiple variables to be set in one operation. In some situations it can result in simpler code than using the more flexible SetWidget.
Content and Attributes
The content of the <$vars> widget is the scope for the value assigned to the variable.
| Attribute | Description |
|---|---|
| {attributes not starting with $} | Each attribute name specifies a variable name. The attribute value is assigned to the variable |
Examples
Consider a case where you need to set multiple variables.
Using the <$vars> widget, this situation may be handled in the following way:
\define helloworld() Hello world!
<$vars greeting="Hi" me={{!!title}} sentence=<<helloworld>>>
<<greeting>>! I am <<me>> and I say: <<sentence>>
</$vars>In contrast, here is the same example using the <$set> widget:
<$set name="greeting" value="Hi" >
<$set name="me" value={{!!title}} >
<$set name="sentence" value=<<helloworld>> >
<<greeting>>! I am <<me>> and I say: <<sentence>>
</$set>
</$set>
</$set>Remarks
It should be noted that this widget differs from the set widget in the following ways:
- A fallback (also known as "emptyValue") cannot be specified
- Filters cannot be used to produce a conditional variable assignement
- Variable names must be literal strings
Están disponibles los siguientes videos sobre TiddlyWiki:
- Video: OXTWIG
- VIdeo: "Hangouts"
- Video: Inicio
- Video: TiddlyDesktop
- Video: Principios básicos
- Video: TiddlyWIki en Firefox Android
La finalidad es mantener una serie de videos que sirvan de guía para la puesta en marcha de TiddlyWiki. Toda contribución es bienvenida.
Introduction
The view widget displays the contents of a tiddler field in a specified format.
Content and Attributes
The content of the <$view> widget is displayed if the field or property is missing or empty.
| Attribute | Description |
|---|---|
| tiddler | The title of the tiddler (defaults to the current tiddler) |
| field | The name of the field to view (defaults to "text") |
| index | The name of the index to view |
| format | The format for displaying the field (see below) |
| template | Optional template string used when the format attribute is set to "date" |
| subtiddler | Optional SubTiddler title when the target tiddler is a plugin (see below) |
| mode | New in: 5.1.15 Optional transclusion parsing mode for wikified formats. May be "inline" or "block" (the default) |
Formats
The following formats can be specified in the format attribute:
| Format | Description |
|---|---|
| text | Plain text |
| htmlencoded | The field is displayed with HTML encoding |
| urlencoded | The field is displayed with URL encoding |
| doubleurlencoded | The field is displayed with double URL encoding |
| htmlwikified | The field is wikified according to the mode attribute and the resulting HTML returned as plain text (ie HTML elements will appear in plain text) |
| plainwikified | The field is wikified according to the mode attribute and the text content of the resulting HTML returned as plain text (ie HTML elements will be removed) |
| htmlencodedplainwikified | The field is wikified according to the mode attribute and the text content of the resulting HTML returned as HTML encoded plain text (ie HTML elements will be removed) |
| date | The field is interpreted as a UTC date and displayed according to the DateFormat specified in the template attribute |
| relativedate | The field is interpreted as a UTC date and displayed as the interval from the present instant |
| stripcomments | The field is interpreted as JavaScript source code and any lines beginning \\# are stripped |
| jsencoded | The field is displayed as a JavaScript encoded string |
SubTiddler Access
The view widget allows access to the individual tiddlers stored within a plugin.
The following example will view the core version of the tiddler $:/DefaultTiddlers even if it has been overridden:
<$view tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
Este es su aspecto:
GettingStartedAn interactive timeline visualisation plugin based on Vis.js. A demo can be found here: http://kixam.github.io/TW5-visjsTimeline/.
vis.js Timeline is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable timelines. This project is a direct continuation of emkay's plugin.
When running under Node.js, TiddlyWiki includes a simple HTTP/HTTPS web server that allows you to use it from any browser running on the same machine or over a network.
How It Works
The web server listens for requests coming over the network, and performs the following actions in turn:
- Authentication is the process of identifying the current user. TiddlyWiki supports three types of authentication: Anonymous, Basic and Header
- Authorization is the process of determining which resources may be accessed by a particular user. TiddlyWiki implements a simple scheme whereby read and write access to the wiki can be independently controlled.
- Routing is the process of dispatching the request to the API handler, and returning any required data.
Usage
Anonymous Access
The web server is started with the ListenCommand (which supersedes the older ServerCommand). All the NamedCommandParameters are optional, so the simplest form is:
tiddlywiki mywikifolder --listenVisit http://127.0.0.1:8080/ to access the wiki. Access is anonymous, so anyone can read or write to the wiki.
This will typically be available only to users on the local machine. For information on how to open the instance to the local network see the Web Server host parameter entry.
Authenticated Access
Adding username and password parameters enforces basic authentication for both reading and writing:
tiddlywiki mywikifolder --listen username=test password=tsetVisiting the wiki will prompt for a username and password, and access is denied if they do not match the provided credentials.
Anonymous Read, Authenticated Write
This example adds the authorization parameters readers and writers to grant read access to anonymous users, but require authentication as "joe" in order to gain write access.
Note that anonymous users can trigger a username/password prompt by visiting the route
\login-basic(eg http://127.0.0.1:8080/login-basic).
tiddlywiki mywikifolder --listen "readers=(anon)" writers=joe username=joe password=bloggsNote the double quotes that are required for parameters containing special characters.
Arguments
The full list of available optional parameters is:
- anon-username
- authenticated-user-header
- credentials
- csrf-disable
- debug-level
- host
- password
- path-prefix
- port
- readers
- root-render-type
- root-serve-type
- root-tiddler
- system-tiddler-render-template
- system-tiddler-render-type
- tiddler-render-template
- tiddler-render-type
- tls-cert
- tls-key
- username
- writers
Guides
Further information on usage of the integrated WebServer:
Delete a tiddler
DELETE /bags/default/tiddlers/{title}Parameters:
- title - URI encoded title of the tiddler to delete
Response:
- 204 No Content
Forces the server to request basic authentication login, and then redirects to the root
GET /login-basicRequests an basic authentication from the browser, and redirects to the root if successful.
Parameters:
- none
Response:
- 302 Found
Location: / - 401 Unauthorized
WWW-Authenticate: Basic realm="Please provide your username and password to login to <servername>"
Gets an array of all raw non-system tiddlers, excluding the text field.
GET /recipes/default/tiddlers.jsonParameters:
- none
Response:
- 200 OK
Content-Type: application/jsonBody: array of all non-system tiddlers in TiddlyWeb JSON tiddler format
Get the favicon for the wiki from the tiddler $:/favicon.ico
GET /favicon.icoParameters:
- none
Response:
- 200 OK
Content-Type: image/x-iconBody: image data from the tiddler $:/favicon.ico
Get the content of a static file. See using the integrated static file server
GET /files/<pathname>Parameters:
- pathname - URI encoded path to the file
Response:
- 200 OK
Content-Type: <content-type>(determined from file extension)Body: data retrieved from file
- 403 Forbidden
- 404 Not Found
Gets a rendering of the specified tiddler. See using the read-only single tiddler view for more details.
GET /{title}Parameters:
- title - URI encoded title of the tiddler to render
Response:
- 200 OK
Content-Type: <content-type>Body: tiddler rendering
- 404 Not Found
Get server status information
GET /statusParameters:
- none
Response:
- 200 OK
Content-Type: application/jsonBody: see below
The JSON data returned comprises the following properties:
- username - the username of the currently authenticated user. If undefined, the WebServer Parameter: anon-username is returned instead
- anonymous - true if the current user is anonymous
- read_only - true if the current user is restricted to read only access to the server
- space - always contains the object
{recipe: "default"} - tiddlywiki_version - the current TiddlyWiki version
For example:
{
"username": "",
"anonymous": true,
"read_only": false,
"space": {
"recipe": "default"
},
"tiddlywiki_version": "5.1.18"
}Gets the raw fields of a tiddler
GET /recipes/default/tiddlers/{title}Parameters:
- title - URI encoded title of the tiddler to retrieve
Response:
- 200 OK
Content-Type: application/jsonBody: tiddler in TiddlyWeb JSON tiddler format
- 404 Not Found
Get the main wiki
GET /The wiki is composed by rendering the tiddler identified in the root-tiddler parameter with the render type in the root-render-type parameter. This is then served with the content type from the root-serve-type parameter.
Parameters:
- none
Response:
- 200 OK
Content-Type: text/htmlBody: data retrieved from file
Saves the raw fields of a tiddler
PUT /recipes/default/tiddlers/{title}The body should be in TiddlyWeb JSON tiddler format.
Parameters:
- title - URI encoded title of the tiddler to save
Response:
- 204 No Content
Content-Type: text/plainEtag: "default/<title>/<changecount>:"
Authentication is the process of identifying the current user. TiddlyWiki supports three types of authentication:
- Anonymous Access allows any user to access resources without requiring authentication. Optionally, a username can still be specified for signing edits
- Basic Authentication requires the user to enter a username and password combination which TiddlyWiki validates against an internal database of credentials
- Header Authentication requires an external proxy to place the username of the current user in a trusted header of the request. It is often used as the basis of "single sign-on" features
Authorization is the process of determining which resources may be accessed by a particular user. It occurs after authentication has determined the identity of the user. TiddlyWiki's WebServer implements a simple authorization scheme which permits independent control of who has read and write access to a wiki.
The WebServer parameters readers and writers each contain a comma separated list of principals (which is to say, either usernames or certain special tokens) which should have read or write access respectively.
The available special tokens are:
- (anon) - indicates all anonymous users
- (authenticated) - indicates all authenticated users
Read-only Mode
Read-only mode is engaged when the current user is not authorized to write to the current wiki.
User interface features concerned with creating or editing content are disabled in read-only mode:
- clone, delete, new-here and new-journal-here tiddler toolbar buttons
- import, manager, new-tiddler new-image and new-journal page control buttons
The tiddler $:/status/IsReadOnly is set to yes when read-only mode is engaged.
Examples
These example use the credentials parameter to specify the location of a file containing usernames and passwords.
In the first example, read access is permitted for the users "joe" and "mary", with write access restricted to "mary":
tiddlywiki mywikifolder --listen credentials=myusers.csv readers=joe,mary writers=maryIn the following example, read access is granted to all authenticated users, but only "mary" is granted write access:
tiddlywiki mywikifolder --listen credentials=myusers.csv "readers=(authenticated)" writers=maryBasic authentication is a standard mechanism for servers to instruct browsers to prompt the user for credentials. It is recommended to use it in association with HTTPS due to the way that it passes unencrypted passwords over the network.
Basic authentication is activated if credentials are specified via the username/password or credentials parameters.
If WebServer Authorization is configured to allow access by both anonymous and authenticated users then by default users will not be prompted for credentials, and will be given anonymous access. To force a password prompt visit the route /login-basic (for example, http://127.0.0.1:8080/login-basic).
Header authentication is a web integration technique enabling external entities to securely pass details of the authenticated user to an application. It is commonly used for "single sign on" in corporate environments.
Header authentication is activated if is configured via the authenticated-user-header
The web server configuration parameter anon-username provides an optional username for signing edits from anonymous users.
Without this parameter, anonymous users will be given a blank username.
The web server configuration parameter authenticated-user-header activates header authentication by specifying the name of the HTTP header that will be used to pass the username to TiddlyWiki.
The web server configuration parameter credentials contains the pathname of a CSV file containing a list of username/password combinations. Using the credentials parameter activates WebServer Basic Authentication.
The CSV file must contain a header row and columns labelled username and password. For example:
username,password
jane,do3
andy,sm1th
roger,m00reNotes:
The web server configuration parameter csrf-disable causes the usual cross-site request forgery checks to be disabled. This might be necessary in unusual or experimental configurations.
Setting csrf-disable to yes disables the CSRF checks; no (or any other value) enables them.
The only currently implemented check is the use of a custom header called x-requested-with that must contain the string TiddlyWiki in order for write requests to succeed.
The web server configuration parameter debug-level determines the level of debugging information printed to the console:
- full - maximum logging
- none - no logging
The web server configuration parameter host is the IP address on which the server listens. The most common settings are:
- 127.0.0.1 (default) - only listens for connections from browsers on the same computer
- 0.0.0.0 - listens for connections on all network interfaces, and thus from any browser on a reachable network
- n.n.n.n - listens for connections on the network interface with the specified IP address
Note: Using 0.0.0.0 or n.n.n.n in a public environment (e.g. coffee shop, library, airport) is inadvisable as it will expose your system to possible intrusion.
The web server configuration parameter password, is used with its companion username as a shortcut for setting user credentials for WebServer Basic Authentication.
The web server configuration parameter path-prefix can be used to set an optional prefix for all paths served.
This example causes the server to serve from http://127.0.0.1/MyApp instead of the default http://127.0.0.1/MyApp.
tiddlywiki mywikifolder --listen "path-prefix=/MyApp"The web server configuration parameter port specifies the TCP port on which the server will listen for connections. The default value is 8080.
The port parameter accepts two types of value:
- Numerical values are interpreted as a decimal port number
- Non-numeric values are interpreted as an environment variable from which the port should be read
This example configures the server to listen on port 8090:
tiddlywiki mywikifolder --listen port=8090This example configures the server to listen on the port specified in the environment variable THE_PORT:
tiddlywiki mywikifolder --listen port=THE_PORTThe web server configuration parameter readers is used to specify the security principals with read access to the wiki. See WebServer Authorization for more details.
The web server configuration parameter root-render-type determines the way that the root wiki tiddler is rendered:
text/plain(default) – the plain text content of the output is rendered (i.e. HTML elements are ignored)text/html– the full HTML content of the output is rendered (i.e. including HTML elements)
The web server configuration parameter root-serve-type determines the content type with which the root wiki tiddler is rendered. The default is text/html.
The web server configuration parameter root-tiddler determines the title of the tiddler that is rendered as the root wiki. The default setting is $:/core/save/all.
The web server configuration parameter system-tiddler-render-template is used to specify the template for serving system tiddlers in the read-only single tiddler view. The default value is $:/core/templates/wikified-tiddler which renders the tiddler raw, without any special viewing template.
The web server configuration parameter system-tiddler-render-type is used to specify the render type for serving system tiddlers in the read-only single tiddler view. The default value is text/plain, causing the raw text of rendered system tiddlers to be returned. Alternatively, text/html can be used to cause the full HTML of the rendered tiddlers to be returned.
The web server configuration parameter tiddler-render-template is used to specify the template for serving ordinary, non-system tiddlers in the read-only single tiddler view. The default value is $:/core/templates/server/static.tiddler.html which renders tiddlers in a lightweight page with a simple sidebar.
The web server configuration parameter tiddler-render-type is used to specify the render type for serving ordinary, non-system tiddlers in the read-only single tiddler view. The default value is text/html, causing the full HTML of the rendered output to be returned. Alternatively, text/html can be used to cause the raw text of rendered system tiddlers to be returned.
The optional web server configuration parameter tls-cert contains the pathname to the certificate file required when running the web server under HTTPS. The pathname is taken relative to the wiki folder.
See Using HTTPS for details.
The optional web server configuration parameter tls-key contains the pathname to the key file required when running the web server under HTTPS. The pathname is taken relative to the wiki folder.
See Using HTTPS for details.
The web server configuration parameter username, in conjunction with its companion password:
- Enables Basic Authentication with the specified username/password combination being added to any credentials specified with the credentials parameter
- The specified username is used as a default value for the readers and writers authorization parameters if they are not specified
Examples
Serve anonymous users, setting the username to "joe":
tiddlywik mywikifolder --listen anon-username=joeRestrict access to the user "joe" with a password of "secret":
tiddlywik mywikifolder --listen username=joe password=secretThe web server configuration parameter writers is used to specify the security principals with write access to the wiki. See WebServer Authorization for more details.
La versión original de TiddlyWiki, que llamamos Classic, sigue disponible en:
https://classic.tiddlywiki.com.
Ten en cuenta que la versión actual de TiddlyWiki no es totalmente compatible con la versión Classic. Se pueden importar contenidos, pero necesitan algo de masaje para adaptarse al nuevo formato de escritura, WikiText.
Actualmente está en desarrollo un plugin: tw2parser, intérprete que permita reproducir fielmente y sin mayor complicación los contenidos creados por TiddlyWikiClassic.
A cross platform server application that can save tiddlers to a local database
https://github.com/opennota/widdly
a minimal self-hosted app, written in Go, that can serve as a backend for a personal TiddlyWiki.
El mensaje tm-add-field define un determinado campo y lo añade con valor en blanco, si dicho campo no existe.
| Nombre | Descripción |
|---|---|
| param | Nombre del campo |
Este mensaje lo genera normalmente ButtonWidget y lo procesa FieldManglerWidget.
EL mensaje tm-add-tag añade la etiqueta que se especifique.
| Name | Description |
|---|---|
| param | Nombre de la etiqueta |
Este mensaje lo genera normalmente ButtonWidget y lo procesa FieldManglerWidget.
El mensaje tm-auto-save-wiki realiza, siempre que sea necesario, el guardado en segundo plano de TiddlyWiki.
El mensaje autosave wiki se genera siempre que se producen cambios en el TiddlerStore. Por ejemplo: tm-save-tiddler, tm-delete-tiddler y tm-perform-import guardan, borran y añaden tiddlers respectivamente, lo que tiene como resultado que, al ser procesados, NavigatorWidget genere el mensaje auto-save-widget.
Lo procesa SyncMechanism en el núcleo de TiddlyWiki, invocando el SaverModule actual. No todos los SaverModules tienen capacidad para hacerlo.
El mensaje tm-browser-refresh recarga la página, causando el reinicio de todos los plugins. No necesita ninguna propiedad del objeto event.
Este mensaje se genera con el ButtonWidget y se procesa en el núcleo.
El mensaje tm-clear-passwordborra la contraseña actual del depósito de claves y cambia el valor de $:/isEncrypted. Consulta EncryptionMechanism para más información.
Este mensaje lo genera normalmente ButtonWidget y lo procesa el propio núcleo.
The "copy to clipboard" message attempts to copy the specified text to the clipboard. If it succeeds, the tiddler $:/language/Notifications/CopiedToClipboard/Succeeded is displayed as a notification. If the browser doesn't permit the operation, the tiddler $:/language/Notifications/CopiedToClipboard/Failed is displayed instead.
It requires the following properties on the event object:
| Name | Description |
|---|---|
| param | Text to be copied to the clipboard |
This message is usually generated with the ButtonWidget. It is handled by the TiddlyWiki core.
Example
This example copies the current time to the clipboard:
<$button message="tm-copy-to-clipboard" param=<<now>>>
Copy date to clipboard
</$button>Este es su aspecto:
El mensaje tm-download-file hace que el SaverModule actual indique al usuario que descargue como archivo el resultado de la interpretación de un determinado tiddler.
Requiere las siguientes propiedades del objeto event:
| Nombre | Descripción |
|---|---|
| param | Título del tiddler usado como plantilla del nuevo tiddler |
| paramObject | HashMap opcional de valores de variable que se usará para la conversión |
Este mensaje lo genera normalmente ButtonWidget y lo procesa SyncMechanism en el núcleo de TiddlyWiki, que invoca el SaverModule actual.
A tm-edit-bitmap-operation invokes one of the available operations on a surrounding bitmap editor. Therefore the message has to be dispatched within the editor in order for it to catch it. The following properties on the event object are required:
| Name | Description |
|---|---|
| param | Name of the operation to be executed, see below for a list of possible operations |
| paramObject | Hashmap of additional parameters required by the operation top be executed |
The tm-edit-bitmap-operation message is usually generated by a ButtonWidget or an ActionWidget and is handled by the surrounding bitmap editor.
Bitmap Operations
At this point the following bitmap operations have been implemented:
| Name | Description | ||||||
|---|---|---|---|---|---|---|---|
| resize | Resizes the image to the specified width and height. Parameters include:
| ||||||
| clear | Clears the contents of the image and fills it with a solid colour. Parameters include:
|
Example
An example can be seen in $:/core/ui/EditorToolbar/size-dropdown:
<$button>
<$action-sendmessage
$message="tm-edit-bitmap-operation"
$param="resize"
width={{$config-title$/new-width}}
height={{$config-title$/new-height}}
/>
...
Resize
</$button>A tm-edit-text-operation invokes one of the available operations on a surrounding text editor. Therefore the message has to be dispatched within the editor in order for it to catch it. The following properties on the event object are required:
| Name | Description |
|---|---|
| param | Name of the operation to be executed, see below for a list of possible operations |
| paramObject | Hashmap of additional parameters required by the operation top be executed |
The tm-edit-text-operation message is usually generated by a ButtonWidget or an ActionWidget and is handled by the surrounding text editor.
Text Operations
At this point the following text operations have been implemented:
| Name | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| excise | Excises the currently selected text into a new tiddler and replaces it with a link, a macro or a transclude of the new tiddler. Parameters include:
| ||||||||||
| replace-all | Replaces all contents of the editor with the provided text.
| ||||||||||
| replace-selection | Replaces the current selection with the provided text.
| ||||||||||
| prefix-lines | Prefixes the currently selected line(s) with the provided character. If a line is already prefixed by the provided prefix, the prefix is removed instead.
Example Setting character=" | ||||||||||
| wrap-lines | Surrounds the selected lines with the provided
| ||||||||||
| wrap-selection | Surrounds the current selection with the provided
| ||||||||||
| save-selection | Saves the text of the current selection into the provided
|
Example
An example can be seen in $:/core/ui/EditorToolbar/bold:
<$action-sendmessage
$message="tm-edit-text-operation"
$param="wrap-selection"
prefix="''"
suffix="''"
/>The tm-focus-selector message sets the focus to the DOM element identified by the selector in the param parameter.
| Name | Description |
|---|---|
| param | Selector identifying the DOM element to be focussed |
| paramObject | Optional hashmap of additional parameters to be passed to the focus() method |
The tm-fold-all-tiddlers message folds all tiddlers in the current story list.
Internally, it sets the text of all of the state tiddlers corresponding to tiddlers in the story river to "hide". The state tiddler titles are formed by prefixing the tiddler title with a prefix that defaults to $:/state/folded/.
| Name | Description |
|---|---|
| foldedStatePrefix | Prefix for the state tiddler in which the fold state is stored. Defaults to $:/state/folded |
The tm-fold-all-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The tm-fold-other-tiddlers message folds all tiddlers in the current story list, except the one specified in the param parameter. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
| Name | Description |
|---|---|
| param | Title of the tiddler that should be ignored by the fold operation. |
| foldedStatePrefix | Prefix for the state tiddler in which the fold state is stored. |
The tm-fold-other-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The tm-fold-tiddler message folds the tiddler specified in the param parameter. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
| Name | Description |
|---|---|
| param | Title of the tiddler that should be folded. If the tiddler is already folded, it will be unfolded instead. |
| foldedStatePrefix | Prefix for the state tiddler in which the fold state is stored. If no state prefix is provided, tm-fold-tiddler will do nothing. |
The tm-fold-tiddler message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
El mensaje tm-full-screen alterna el modo de vista en pantalla completa, si el navegador lo permite.
Este mensaje lo procesa el núcleo de TiddlyWiki.
El mensaje tm-home cierra cualquier tiddler que se haya abierto y abre los tiddlers por defecto definidos en $:/DefaultTiddlers.
También elimina cualquier permalink de la barra de dirección del navegador
No requiere propiedad alguna del objeto event.
Este mensaje normalmente lo genera ButtonWidget y lo procesa el núcleo de TiddlyWiki.
The tm-load-plugin-from-library message load the specified tiddler or plugin from the specified plugin library.
| Name | Description |
|---|---|
| title | Title of the tiddler or plugin to be loaded into the current wiki |
| url | Url specifying the plugin library from which the tiddler or plugin is to be loaded. |
Example
The following snippet will install the CodeMirror plugin from the official plugin library:
<$button>
<$action-sendmessage $message="tm-load-plugin-from-library" title="$:/plugins/tiddlywiki/codemirror" url="https://tiddlywiki.com/library/v5.1.11/index.html"/>
Install CodeMirror
</$button>The tm-load-plugin-from-library message is usually generated with the ButtonWidget and is handled by the core itself.
The tm-load-plugin-library message loads the specified plugin library and imports information about the contained plugins in temporary tiddlers.
| Name | Description |
|---|---|
| url | Url specifying the plugin library to be loaded. |
| infoTitlePrefix | Prefix to the temporary tiddlers being created, containing information about the plugins the plugin library offers. Defaults to $:/temp/RemoteAssetInfo/ |
Example
The following snippet will load the official plugin library:
<$button>
<$action-sendmessage $message="tm-load-plugin-library" infoTitlePrefix="$:/temp/RemoteAssetInfo/" url="https://tiddlywiki.com/library/v5.1.11/index.html"/>
Load official plugin library
</$button>The tm-load-plugin-library message is usually generated with the ButtonWidget and is handled by the core itself.
El mensaje tm-login pide al usuario que introduzca un nombre de usuario y contraseña e intenta iniciar sesión en el servidor. El tiddler $:/status/IsLoggedIn informa del actual estado de inicio de sesión con los valores "yes" o "no" y $:/status/UserName indica el nombre de usuario actual.
Este mensaje lo procesa SyncMechanism en el núcleo de TiddlyWiki invocando el SyncAdaptorModule actual, (generalmente, el plugin tiddlywiki/tiddlywebadaptor).
El mensaje tm-logout desconecta al usuario de su sesión actual en el servidor.
El tiddler $:/status/IsLoggedIn indica el estado actual de inicio de sesión con los valores "yes" o "no" y $:/status/UserName indica el nombre de usuario actual
Este mensaje lo procesa SyncMechanism en el núcleo de TiddlyWiki invocando el SyncAdaptorModule actual, (generalmente, el plugin tiddlywiki/tiddlywebadaptor).
El mensaje tm-modal muestra determinado tiddler sobre una ventana modal que atenúa la página principal. Requiere de las siguientes propiedades en el objeto event:
| Nombre | Descripción |
|---|---|
| param | Título del tiddler que se quiere mostrar |
| paramObject | HashMap de variables que se le suministra al modal |
La variable current tiddler se asigna al tiddler modal, pero puede anularse especificando un valor diferente en paramObject.
Este mensaje se genera normalmente con ButtonWidget y lo procesa el núcleo de TiddlyWiki.
Ejemplo
Este es un ejemplo de modal y de cómo se le pasan parámetros:
Escribe tu nombre: <$edit-text tiddler="$:/temp/yourName" tag="input" default="Nombre"/>
Escribe tu mensaje:
<$edit-text tiddler="$:/temp/yourMessage" default="Mensaje"/>
<$button>
<$action-sendmessage $message="tm-modal" $param="SampleModal" yourName={{$:/temp/yourName}} yourMessage={{$:/temp/yourMessage}}/>
¡Haz clic!
</$button>Este es su aspecto:
Escribe tu nombre:
Escribe tu mensaje:
El mensaje tm-navigate inserta el tiddler que se indica en la StoryList y lo coloca al inicio de la HistoryList. Si el tiddler no está ya en la StoryList, se colocará inmediatamente después del que se especifique en event.navigateFromTitle.
Este mensaje precisa de las siguientes propiedades del objeto event:
| Nombre | Descripción |
|---|---|
| navigateTo | Título del tiddler al que se navega |
| navigateFromTitle | Título del tiddler desde el que se inicia la navegación |
| navigateFromClientRect | Coordenadas en la página cliente del cuadro del elemento que inicia la navegación |
| navigateSuppressNavigation | true hace que el nuevo tiddler se añada a la StoryList, sin sumarse a la HistoryList. Esto suprime el desplazamiento asociado con la navegación a un tiddler |
Este mensaje pueden generarlo LinkWidget, ActionNavigateWidget y ButtonWidget, pero lo procesa NavigatorWidget.
El mensaje tm-notify muestra un tiddler determinado como una pequeña alerta en la esquina superior derecha de la página. Requiere las siguientes propiedades del objeto event:
| Nombre | Descripción |
|---|---|
| param | Título del tiddler que se mostrará |
Este mensaje lo procesa el núcleo de TiddlyWiki
New in: 5.1.14
The tm-open-external-window message opens an external link eg: "http://tiddlywiki.com" in a new browser window. If no parameters are specified, it opens the help tiddler. Any additional parameters passed via the paramObject are being provided as variables to the new window.
| Name | Description |
|---|---|
| param | URL of the tiddler to be opened in a new browser window, defaults to the TiddlyWiki help |
| paramObject | Optional: Hashmap of variables that will be provided to the window. see below |
parmObject
| Name | Description | Important |
|---|---|---|
| windowName | If a parameter is provided it can be used to open different links in the same window eg: _tiddlywiki. Default is empty, so every link opens a new window. | The behaviour is influenced by user settings in the browser and the browsers default behavior! |
| windowFeatures | This parameter needs to be provided as a single string. eg: "height=400, width=600". For detailed description about possible parameters see: Mozilla Help |
The tm-open-external-window message is usually generated with the ButtonWidget or ActionSendMessageWidget and is handled by the core itself.
Examples
<$button>
<$action-sendmessage $message="tm-open-external-window" $param="http://tiddlywiki.com" windowName="_tiddlywiki" windowFeatures="height=500, width=900"/>
Open ~TiddlyWiki - Action
</$button>
<$button>
<$action-sendmessage $message="tm-open-external-window" $param="https://developer.mozilla.org/en-US/docs/Web/API/Window/open" windowName="_tiddlywiki" windowFeatures="height=400, width=600"/>
Open Mozilla Help - Action
</$button>
<$button message="tm-open-external-window" param="http://tiddlywiki.com" >
Open ~TiddlyWiki - Button
</$button>Este es su aspecto:
The tm-open-window message opens a tiddler in a new browser window. If no parameters are specified, the current tiddler is opened in a new window. Similiar to tm-modal any additional parameters passed via the paramObject are being provided as variables to the new window.
| Name | Description |
|---|---|
| param | Title of the tiddler to be opened in a new browser window, defaults to currentTiddler if empty |
| template | Template in which the tiddler will be rendered in |
| windowTitle | Title string for the opened window |
| width | Width of the new browser window |
| height | Height of the new browser window |
| paramObject | Hashmap of variables that will be provided to the window |
The tm-open-window message is usually generated with the ButtonWidget and is handled by the core itself.
El mensaje tm-permalink cambia la dirección de la barra del navegador para formar un permalink: dirección web que lleva hasta un tiddler específico (por defecto, el tiddler actual).
Este mensaje permite las siguientes propiedades del objeto event:
| Nombre | Descripción |
|---|---|
| param | Título del tiddler para el permalink |
| tiddlerTitle | El tiddler actual (usado por defecto si no se especifica otro en el param) |
Este mensaje puede generarse con el ButtonWidget y lo procesa el mecanismo StoryMechanism
El mensaje tm-permaview cambia la dirección del navegador para formar una permaview: dirección web que especifica qué tiddlers aparecerán abiertos en el StoryRiver y entre estos, cuál se muestra primero en pantalla (por defecto, el tiddler actual).
Este mensaje permite las siguientes propiedades del objeto event:
| Nombre | Descripción |
|---|---|
| param | Título del tiddler de la permaview que primero se mostrará en pantalla |
| tiddlerTitle | Tiddler actual (usado por defecto si no se especifica otro en el param) |
Este mensaje puede generarse con el ButtonWidget y lo procesa el mecanismo StoryMechanism
New in: 5.1.14 The tm-print message causes the browser to display the print dialog for the current page. It does not require any properties on the event object.
The print message is usually generated with the ButtonWidget and is handled by the core.
El mensaje tm-remove-field elimina el campo especificado.
| Nombre | Descripción |
|---|---|
| param | Nombre del campo para eliminar |
Este mensaje se genera normalmente con ButtonWidget y lo procesa FieldManglerWidget.
El mensaje tm-remove-tag elimina la etiqueta especificada.
| Name | Description |
|---|---|
| param | Nombre de etiqueta para borrar |
Este mensaje normalmente se genera con ButtonWidget y lo procesa FieldManglerWidget.
El mensaje tm-save-wikihace que el SaverModule actual realice una operación de guardado de todo el wiki. Dicha operación puede requerir intervención del usuario. Precisa de las siguientes propiedades en el objeto event:
| Nombre | Descripción |
|---|---|
| param | Título del tiddler que sirve de plantilla para generar el wiki. (por defecto $:/core/save/all) |
| paramObject | HashMap opcional de valores de variable para usar al generar el wiki |
Este mensaje lo genera habitualmente ButtonWidget.
The save wiki message is usually generated by the ButtonWidget.
El SyncMechanism del núcleo es quien procesa este mensaje invocando el SaverModule actual.
The tm-scroll message causes the surrounding scrollable container to scroll to the specified DOM node into view. The tm-scroll is handled in various places in the core itself, but can also be handled by a ScrollableWidget.
| Name | Description |
|---|---|
| target | Target DOM node the scrollable container should scroll to. |
Due to the nature of the parameter, the tm-scroll can only be generated within javascript code.
El mensaje tm-server-refresh intenta sincronizar con el servidor los últimos cambios del cliente.
El SyncMechanism del núcleo es quien procesa este mensaje invocando el Módulo de sincronización actual, (normalmente, el plugin tiddlywiki/tiddlywebadaptor).
El mensaje tm-set-passwordpide al usuario que establezca una contraseña y la guarda en el depósito, sustituyendo cualquier otra contraseña que se hubiera guardado anteriormente. Como consecuencia, establece también el valor de $:/isEncrypted
Más detalles en EncryptionMechanism.
Este mensaje lo genera habitualmente ButtonWidget y se procesa en el propio núcleo.
The tm-unfold-all-tiddlers message unfolds all tiddlers in the current story list. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
| Name | Description |
|---|---|
| foldedStatePrefix | Prefix for the state tiddler in which the fold state is stored. |
The tm-unfold-all-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The tm-unload-plugin-library message unloads the specified plugin library and deletes associated temporary tiddlers.
| Name | Description |
|---|---|
| url | Url specifying the plugin library to be unloaded |
Unloading a plugin library deletes the following tiddlers:
- The tiddler titled
$:/temp/ServerConnection/+<url> - All tiddlers with the prefix
$:/temp/RemoteAssetInfo/+<url>+/
The tm-unload-plugin-library message is usually generated with the ButtonWidget and is handled by the core itself.
TiddlyWiki's display is driven by an underlying collection of widgets. These are organised into a tree structure: each widget has a parent widget and zero or more child widgets.
TiddlyWiki generates this widget tree by parsing the WikiText of tiddlers. Each component of the WikiText syntax, including even the trivial case of ordinary text, generates a corresponding widget. The widget tree is an intermediate representation that is subsequently rendered into the actual display.
Widgets are analogous to elements in an HTML document. Indeed, HTML tags in WikiText generate dedicated element widgets.
Each class of widget contributes a specific ability to the overall functionality, such as the ability to display an image or a button, to call a macro or transclude text from elsewhere, or to mark a piece of text as a heading.
The more specialised widgets use a general-purpose widget syntax as their only possible WikiText representation.
The following classes of widget are built into the core:
- action-createtiddler
- action-deletefield
- action-deletetiddler
- action-listops
- action-navigate
- action-sendmessage
- action-setfield
- ActionWidgets
- browse
- button
- checkbox
- codeblock
- Widgets: Count
- diff-text
- draggable
- droppable
- dropzone
- edit-bitmap
- edit-text
- edit
- encrypt
- entity
- fieldmangler
- fields
- image
- importvariables
- keyboard
- linkcatcher
- link
- list
- macrocall
- navigator
- password
- radio
- range
- reveal
- scrollable
- select
- setvariable
- set
- text
- tiddler
- transclude
- vars
- view
- wikify
Widgets provide rich functionality within WikiText. They have the same syntax as HTML elements, but the tag name always starts with $. For example:
<$button message="tm-close-tiddler">Close Me!</$button>Note that widgets inherit all the features of HTML in WikiText:
- Widget attributes can be specified as:
- Unquoted strings (that cannot contain spaces)
- Strings quoted with single or double quotes
- Strings quoted with triple-double quotes
- Macro invocations (eg
attr=<<myMacro>>) - Transclusions (eg,
attr={{MyTiddler!!field}}) - Filtered transclusions (eg,
attr={{{ [filter[op]] }}})
- The content of a widget is parsed in inline mode unless the opening tag is followed by two linebreaks, which forces block mode
- 'Inline mode' means that 'block mode' parse rules like headings, tables and lists are not recognised
See HTML in WikiText for more details.
The available widgets include:
- action-createtiddler
- action-deletefield
- action-deletetiddler
- action-listops
- action-navigate
- action-sendmessage
- action-setfield
- ActionWidgets
- browse
- button
- checkbox
- codeblock
- Widgets: Count
- diff-text
- draggable
- droppable
- dropzone
- edit-bitmap
- edit-text
- edit
- encrypt
- entity
- fieldmangler
- fields
- image
- importvariables
- keyboard
- linkcatcher
- link
- list
- macrocall
- navigator
- password
- radio
- range
- reveal
- scrollable
- select
- setvariable
- set
- text
- tiddler
- transclude
- vars
- view
- wikify
Introduction
The wikify widget parses and renders a string of text and assigns the result to a specified variable. The new value of the variable is available to the content within the wikify widget.
Content and Attributes
The content of the <$wikify> widget is the scope for the value assigned to the variable.
| Attribute | Description |
|---|---|
| name | The name of the variable to assign |
| text | The text to parse and render |
| type | The ContentType of the text (defaults to text/vnd.tiddlywiki) |
| mode | The parse mode: block (the default) or inline |
| output | Keyword indicating the desired output type, defaulting to text (see below) |
The available output types are:
| Keyword | Description |
|---|---|
| text | Return the plain text of the rendered output (ie HTML tags are omitted) |
| formattedtext | Return the plain text with simple text formatting of the rendered output (ie HTML tags are omitted) |
| html | Return the rendered HTML of the output |
| parsetree | Return a formatted JSON representation of the parse tree |
| widgettree | Return a formatted JSON representation of the widget tree |
WikiText is a concise, expressive way of typing a wide range of text formatting, hypertext and interactive features. It allows you to focus on writing without a complex user interface getting in the way. It is designed to be familiar for users of MarkDown, but with more of a focus on linking and the interactive features.
WikiText can also be inserted to the text field using the Editor toolbar.
See Formatting text in TiddlyWiki for an introduction to WikiText.
The following elements of WikiText syntax are built into the core:
En Windows es posible convertir TiddlyWiki en aplicación local cambiando la extensión .html por .hta (HTML-Application).
Con este cambio se permite que el módulo fsosaver use el FileSystemObject de ActiveX para guardar los cambios.
Hay que tener presente que con este enfoque el archivo TiddlyWiki se guarda codificado en formato UTF-16, que tiene la desventaja de hacerlo el doble de grande que con la codificación habitual en UTF-8. SIn embargo, abrir el archivo y guardarlo por otro medio lo vuelve a codificar como UTF-8.
En la Wikipedia encontrarás más detalles sobre las aplicaciones HTML o HTA:
Introduction
If you want to contribute to TiddlyWiki's development, rather than installing TiddlyWiki in the usual way, you can work directly with the GitHub repository.
Mario Pietsch has created a short video introduction.
Setting Up
- Create an account on GitHub if you don't already have one
- Fork the TiddlyWiki5 GitHub repository from https://github.com/Jermolene/TiddlyWiki5
- Clone a local copy of your fork
- Open a command line terminal and change the current working directory to the root of the repo
- Type
npm link(Windows) orsudo npm link(Mac/Linux) to tell npm to use this copy of the repo as the globally installed one
After this procedure you can work with TiddlyWiki5 via npm as though it were installed in the usual way with npm install -g tiddlywiki.
See also Scripts for TiddlyWiki on Node.js.
Información de ayuda para empezar a usar TiddlyWiki:
- Primera regla de uso
- En Marcha
- Video: Inicio
- Actualizaciones
- Desplazamiento entre tiddlers abiertos
- Desplazarse con enlaces
- Búsquedas
- Edición de tiddlers
- Entradas de diario
- Guardar en TiddlyWiki
- Formatos en TiddlyWiki
- Estructurar TiddlyWiki
- Etiquetas
- Imágenes en WikiText
- Atajos de teclado
- Cifrado
- Video: Principios básicos
- Audio
- Navegadores compatibles
- Performance
The XLSX Utilities edition of TiddlyWiki contains tools to work with .XLSX spreadsheets generated by applications like Microsoft Excel and Google Sheets. It can be used in the browser or under Node.js.